@galacean/engine-core 1.2.0-alpha.2 → 1.2.0-alpha.4

package/dist/module.js

@@ -3288,7 +3288,7 @@ var PBRShaderLib = {
 
 var ShadowCoord = "#define GLSLIFY 1\nuniform mat4 scene_ShadowMatrices[SCENE_SHADOW_CASCADED_COUNT+1];uniform vec4 scene_ShadowSplitSpheres[4];mediump int computeCascadeIndex(vec3 positionWS){vec3 fromCenter0=positionWS-scene_ShadowSplitSpheres[0].xyz;vec3 fromCenter1=positionWS-scene_ShadowSplitSpheres[1].xyz;vec3 fromCenter2=positionWS-scene_ShadowSplitSpheres[2].xyz;vec3 fromCenter3=positionWS-scene_ShadowSplitSpheres[3].xyz;mediump vec4 comparison=vec4(dot(fromCenter0,fromCenter0)<scene_ShadowSplitSpheres[0].w,dot(fromCenter1,fromCenter1)<scene_ShadowSplitSpheres[1].w,dot(fromCenter2,fromCenter2)<scene_ShadowSplitSpheres[2].w,dot(fromCenter3,fromCenter3)<scene_ShadowSplitSpheres[3].w);comparison.yzw=clamp(comparison.yzw-comparison.xyz,0.0,1.0);mediump vec4 indexCoefficient=vec4(4.0,3.0,2.0,1.0);mediump int index=4-int(dot(comparison,indexCoefficient));return index;}vec3 getShadowCoord(){\n#if SCENE_SHADOW_CASCADED_COUNT == 1\nmediump int cascadeIndex=0;\n#else\nmediump int cascadeIndex=computeCascadeIndex(v_pos);\n#endif\n#ifdef GRAPHICS_API_WEBGL2\nmat4 shadowMatrix=scene_ShadowMatrices[cascadeIndex];\n#else\nmat4 shadowMatrix;\n#if SCENE_SHADOW_CASCADED_COUNT == 4\nif(cascadeIndex==0){shadowMatrix=scene_ShadowMatrices[0];}else if(cascadeIndex==1){shadowMatrix=scene_ShadowMatrices[1];}else if(cascadeIndex==2){shadowMatrix=scene_ShadowMatrices[2];}else if(cascadeIndex==3){shadowMatrix=scene_ShadowMatrices[3];}else{shadowMatrix=scene_ShadowMatrices[4];}\n#endif\n#if SCENE_SHADOW_CASCADED_COUNT == 2\nif(cascadeIndex==0){shadowMatrix=scene_ShadowMatrices[0];}else if(cascadeIndex==1){shadowMatrix=scene_ShadowMatrices[1];}else{shadowMatrix=scene_ShadowMatrices[2];}\n#endif\n#if SCENE_SHADOW_CASCADED_COUNT == 1\nif(cascadeIndex==0){shadowMatrix=scene_ShadowMatrices[0];}else{shadowMatrix=scene_ShadowMatrices[1];}\n#endif\n#endif\nvec4 shadowCoord=shadowMatrix*vec4(v_pos,1.0);return shadowCoord.xyz;}"; // eslint-disable-line
 
-var ShadowFragmentDeclaration = "#define GLSLIFY 1\n#if defined(SCENE_SHADOW_TYPE) && defined(RENDERER_IS_RECEIVE_SHADOWS)\n#define SCENE_IS_CALCULATE_SHADOWS\n#endif\n#ifdef SCENE_IS_CALCULATE_SHADOWS\n#if SCENE_SHADOW_CASCADED_COUNT == 1\nvarying vec3 v_shadowCoord;\n#else\n#include <ShadowCoord>\n#endif\nuniform vec3 scene_ShadowInfo;uniform vec4 scene_ShadowMapSize;\n#ifdef GRAPHICS_API_WEBGL2\nuniform mediump sampler2DShadow scene_ShadowMap;\n#define SAMPLE_TEXTURE2D_SHADOW(textureName, coord3) textureLod(textureName, coord3 , 0.0)\n#define TEXTURE2D_SHADOW_PARAM(shadowMap) mediump sampler2DShadow shadowMap\n#else\nuniform sampler2D scene_ShadowMap;\n#ifdef ENGINE_NO_DEPTH_TEXTURE\nconst vec4 bitShift=vec4(1.0,1.0/256.0,1.0/(256.0*256.0),1.0/(256.0*256.0*256.0));float unpack(const in vec4 rgbaDepth){return dot(rgbaDepth,bitShift);}\n#define SAMPLE_TEXTURE2D_SHADOW(textureName, coord3) (unpack(texture2D(textureName, coord3.xy)) < coord3.z ? 0.0 : 1.0)\n#else\n#define SAMPLE_TEXTURE2D_SHADOW(textureName, coord3) (texture2D(textureName, coord3.xy).r < coord3.z ? 0.0 : 1.0)\n#endif\n#define TEXTURE2D_SHADOW_PARAM(shadowMap) mediump sampler2D shadowMap\n#endif\n#if SCENE_SHADOW_TYPE == 2\nfloat sampleShadowMapFiltered4(TEXTURE2D_SHADOW_PARAM(shadowMap),vec3 shadowCoord,vec4 shadowMapSize){float attenuation;vec4 attenuation4;vec2 offset=shadowMapSize.xy/2.0;vec3 shadowCoord0=shadowCoord+vec3(-offset,0.0);vec3 shadowCoord1=shadowCoord+vec3(offset.x,-offset.y,0.0);vec3 shadowCoord2=shadowCoord+vec3(-offset.x,offset.y,0.0);vec3 shadowCoord3=shadowCoord+vec3(offset,0.0);attenuation4.x=SAMPLE_TEXTURE2D_SHADOW(shadowMap,shadowCoord0);attenuation4.y=SAMPLE_TEXTURE2D_SHADOW(shadowMap,shadowCoord1);attenuation4.z=SAMPLE_TEXTURE2D_SHADOW(shadowMap,shadowCoord2);attenuation4.w=SAMPLE_TEXTURE2D_SHADOW(shadowMap,shadowCoord3);attenuation=dot(attenuation4,vec4(0.25));return attenuation;}\n#endif\n#if SCENE_SHADOW_TYPE == 3\n#include <shadow_sample_tent>\nfloat sampleShadowMapFiltered9(TEXTURE2D_SHADOW_PARAM(shadowMap),vec3 shadowCoord,vec4 shadowmapSize){float attenuation;float fetchesWeights[9];vec2 fetchesUV[9];sampleShadowComputeSamplesTent5x5(shadowmapSize,shadowCoord.xy,fetchesWeights,fetchesUV);attenuation=fetchesWeights[0]*SAMPLE_TEXTURE2D_SHADOW(shadowMap,vec3(fetchesUV[0].xy,shadowCoord.z));attenuation+=fetchesWeights[1]*SAMPLE_TEXTURE2D_SHADOW(shadowMap,vec3(fetchesUV[1].xy,shadowCoord.z));attenuation+=fetchesWeights[2]*SAMPLE_TEXTURE2D_SHADOW(shadowMap,vec3(fetchesUV[2].xy,shadowCoord.z));attenuation+=fetchesWeights[3]*SAMPLE_TEXTURE2D_SHADOW(shadowMap,vec3(fetchesUV[3].xy,shadowCoord.z));attenuation+=fetchesWeights[4]*SAMPLE_TEXTURE2D_SHADOW(shadowMap,vec3(fetchesUV[4].xy,shadowCoord.z));attenuation+=fetchesWeights[5]*SAMPLE_TEXTURE2D_SHADOW(shadowMap,vec3(fetchesUV[5].xy,shadowCoord.z));attenuation+=fetchesWeights[6]*SAMPLE_TEXTURE2D_SHADOW(shadowMap,vec3(fetchesUV[6].xy,shadowCoord.z));attenuation+=fetchesWeights[7]*SAMPLE_TEXTURE2D_SHADOW(shadowMap,vec3(fetchesUV[7].xy,shadowCoord.z));attenuation+=fetchesWeights[8]*SAMPLE_TEXTURE2D_SHADOW(shadowMap,vec3(fetchesUV[8].xy,shadowCoord.z));return attenuation;}\n#endif\nfloat sampleShadowMap(){\n#if SCENE_SHADOW_CASCADED_COUNT == 1\nvec3 shadowCoord=v_shadowCoord;\n#else\nvec3 shadowCoord=getShadowCoord();\n#endif\nfloat attenuation=1.0;if(shadowCoord.z>0.0&&shadowCoord.z<1.0){\n#if SCENE_SHADOW_TYPE == 1\nattenuation=SAMPLE_TEXTURE2D_SHADOW(scene_ShadowMap,shadowCoord);\n#endif\n#if SCENE_SHADOW_TYPE == 2\nattenuation=sampleShadowMapFiltered4(scene_ShadowMap,shadowCoord,scene_ShadowMapSize);\n#endif\n#if SCENE_SHADOW_TYPE == 3\nattenuation=sampleShadowMapFiltered9(scene_ShadowMap,shadowCoord,scene_ShadowMapSize);\n#endif\nattenuation=mix(1.0,attenuation,scene_ShadowInfo.x);}return attenuation;}\n#endif\n"; // eslint-disable-line
+var ShadowFragmentDeclaration = "#define GLSLIFY 1\n#if defined(SCENE_SHADOW_TYPE) && defined(RENDERER_IS_RECEIVE_SHADOWS)\n#define SCENE_IS_CALCULATE_SHADOWS\n#endif\n#ifdef SCENE_IS_CALCULATE_SHADOWS\n#if SCENE_SHADOW_CASCADED_COUNT == 1\nvarying vec3 v_shadowCoord;\n#else\n#include <ShadowCoord>\n#endif\nuniform vec4 scene_ShadowInfo;uniform vec4 scene_ShadowMapSize;\n#ifdef GRAPHICS_API_WEBGL2\nuniform mediump sampler2DShadow scene_ShadowMap;\n#define SAMPLE_TEXTURE2D_SHADOW(textureName, coord3) textureLod(textureName, coord3 , 0.0)\n#define TEXTURE2D_SHADOW_PARAM(shadowMap) mediump sampler2DShadow shadowMap\n#else\nuniform sampler2D scene_ShadowMap;\n#ifdef ENGINE_NO_DEPTH_TEXTURE\nconst vec4 bitShift=vec4(1.0,1.0/256.0,1.0/(256.0*256.0),1.0/(256.0*256.0*256.0));float unpack(const in vec4 rgbaDepth){return dot(rgbaDepth,bitShift);}\n#define SAMPLE_TEXTURE2D_SHADOW(textureName, coord3) (unpack(texture2D(textureName, coord3.xy)) < coord3.z ? 0.0 : 1.0)\n#else\n#define SAMPLE_TEXTURE2D_SHADOW(textureName, coord3) (texture2D(textureName, coord3.xy).r < coord3.z ? 0.0 : 1.0)\n#endif\n#define TEXTURE2D_SHADOW_PARAM(shadowMap) mediump sampler2D shadowMap\n#endif\n#if SCENE_SHADOW_TYPE == 2\nfloat sampleShadowMapFiltered4(TEXTURE2D_SHADOW_PARAM(shadowMap),vec3 shadowCoord,vec4 shadowMapSize){float attenuation;vec4 attenuation4;vec2 offset=shadowMapSize.xy/2.0;vec3 shadowCoord0=shadowCoord+vec3(-offset,0.0);vec3 shadowCoord1=shadowCoord+vec3(offset.x,-offset.y,0.0);vec3 shadowCoord2=shadowCoord+vec3(-offset.x,offset.y,0.0);vec3 shadowCoord3=shadowCoord+vec3(offset,0.0);attenuation4.x=SAMPLE_TEXTURE2D_SHADOW(shadowMap,shadowCoord0);attenuation4.y=SAMPLE_TEXTURE2D_SHADOW(shadowMap,shadowCoord1);attenuation4.z=SAMPLE_TEXTURE2D_SHADOW(shadowMap,shadowCoord2);attenuation4.w=SAMPLE_TEXTURE2D_SHADOW(shadowMap,shadowCoord3);attenuation=dot(attenuation4,vec4(0.25));return attenuation;}\n#endif\n#if SCENE_SHADOW_TYPE == 3\n#include <shadow_sample_tent>\nfloat sampleShadowMapFiltered9(TEXTURE2D_SHADOW_PARAM(shadowMap),vec3 shadowCoord,vec4 shadowmapSize){float attenuation;float fetchesWeights[9];vec2 fetchesUV[9];sampleShadowComputeSamplesTent5x5(shadowmapSize,shadowCoord.xy,fetchesWeights,fetchesUV);attenuation=fetchesWeights[0]*SAMPLE_TEXTURE2D_SHADOW(shadowMap,vec3(fetchesUV[0].xy,shadowCoord.z));attenuation+=fetchesWeights[1]*SAMPLE_TEXTURE2D_SHADOW(shadowMap,vec3(fetchesUV[1].xy,shadowCoord.z));attenuation+=fetchesWeights[2]*SAMPLE_TEXTURE2D_SHADOW(shadowMap,vec3(fetchesUV[2].xy,shadowCoord.z));attenuation+=fetchesWeights[3]*SAMPLE_TEXTURE2D_SHADOW(shadowMap,vec3(fetchesUV[3].xy,shadowCoord.z));attenuation+=fetchesWeights[4]*SAMPLE_TEXTURE2D_SHADOW(shadowMap,vec3(fetchesUV[4].xy,shadowCoord.z));attenuation+=fetchesWeights[5]*SAMPLE_TEXTURE2D_SHADOW(shadowMap,vec3(fetchesUV[5].xy,shadowCoord.z));attenuation+=fetchesWeights[6]*SAMPLE_TEXTURE2D_SHADOW(shadowMap,vec3(fetchesUV[6].xy,shadowCoord.z));attenuation+=fetchesWeights[7]*SAMPLE_TEXTURE2D_SHADOW(shadowMap,vec3(fetchesUV[7].xy,shadowCoord.z));attenuation+=fetchesWeights[8]*SAMPLE_TEXTURE2D_SHADOW(shadowMap,vec3(fetchesUV[8].xy,shadowCoord.z));return attenuation;}\n#endif\nfloat getShadowFade(vec3 positionWS){vec3 camToPixel=positionWS-camera_Position;float distanceCamToPixel2=dot(camToPixel,camToPixel);return saturate(distanceCamToPixel2*scene_ShadowInfo.z+scene_ShadowInfo.w);}float sampleShadowMap(){\n#if SCENE_SHADOW_CASCADED_COUNT == 1\nvec3 shadowCoord=v_shadowCoord;\n#else\nvec3 shadowCoord=getShadowCoord();\n#endif\nfloat attenuation=1.0;if(shadowCoord.z>0.0&&shadowCoord.z<1.0){\n#if SCENE_SHADOW_TYPE == 1\nattenuation=SAMPLE_TEXTURE2D_SHADOW(scene_ShadowMap,shadowCoord);\n#endif\n#if SCENE_SHADOW_TYPE == 2\nattenuation=sampleShadowMapFiltered4(scene_ShadowMap,shadowCoord,scene_ShadowMapSize);\n#endif\n#if SCENE_SHADOW_TYPE == 3\nattenuation=sampleShadowMapFiltered9(scene_ShadowMap,shadowCoord,scene_ShadowMapSize);\n#endif\nfloat shadowFade=getShadowFade(v_pos);attenuation=mix(1.0,mix(attenuation,1.0,shadowFade),scene_ShadowInfo.x);}return attenuation;}\n#endif\n"; // eslint-disable-line
 
 var shadow_sample_tent = "#define GLSLIFY 1\nfloat sampleShadowGetIRTriangleTexelArea(float triangleHeight){return triangleHeight-0.5;}void sampleShadowGetTexelAreasTent3x3(float offset,out vec4 computedArea,out vec4 computedAreaUncut){float a=offset+0.5;float offsetSquaredHalved=a*a*0.5;computedAreaUncut.x=computedArea.x=offsetSquaredHalved-offset;computedAreaUncut.w=computedArea.w=offsetSquaredHalved;computedAreaUncut.y=sampleShadowGetIRTriangleTexelArea(1.5-offset);float clampedOffsetLeft=min(offset,0.0);float areaOfSmallLeftTriangle=clampedOffsetLeft*clampedOffsetLeft;computedArea.y=computedAreaUncut.y-areaOfSmallLeftTriangle;computedAreaUncut.z=sampleShadowGetIRTriangleTexelArea(1.5+offset);float clampedOffsetRight=max(offset,0.0);float areaOfSmallRightTriangle=clampedOffsetRight*clampedOffsetRight;computedArea.z=computedAreaUncut.z-areaOfSmallRightTriangle;}void sampleShadowGetTexelWeightsTent5x5(float offset,out vec3 texelsWeightsA,out vec3 texelsWeightsB){vec4 areaFrom3texelTriangle;vec4 areaUncutFrom3texelTriangle;sampleShadowGetTexelAreasTent3x3(offset,areaFrom3texelTriangle,areaUncutFrom3texelTriangle);texelsWeightsA.x=0.16*(areaFrom3texelTriangle.x);texelsWeightsA.y=0.16*(areaUncutFrom3texelTriangle.y);texelsWeightsA.z=0.16*(areaFrom3texelTriangle.y+1.0);texelsWeightsB.x=0.16*(areaFrom3texelTriangle.z+1.0);texelsWeightsB.y=0.16*(areaUncutFrom3texelTriangle.z);texelsWeightsB.z=0.16*(areaFrom3texelTriangle.w);}void sampleShadowComputeSamplesTent5x5(vec4 shadowMapTextureTexelSize,vec2 coord,out float fetchesWeights[9],out vec2 fetchesUV[9]){vec2 tentCenterInTexelSpace=coord.xy*shadowMapTextureTexelSize.zw;vec2 centerOfFetchesInTexelSpace=floor(tentCenterInTexelSpace+0.5);vec2 offsetFromTentCenterToCenterOfFetches=tentCenterInTexelSpace-centerOfFetchesInTexelSpace;vec3 texelsWeightsUA,texelsWeightsUB;vec3 texelsWeightsVA,texelsWeightsVB;sampleShadowGetTexelWeightsTent5x5(offsetFromTentCenterToCenterOfFetches.x,texelsWeightsUA,texelsWeightsUB);sampleShadowGetTexelWeightsTent5x5(offsetFromTentCenterToCenterOfFetches.y,texelsWeightsVA,texelsWeightsVB);vec3 fetchesWeightsU=vec3(texelsWeightsUA.xz,texelsWeightsUB.y)+vec3(texelsWeightsUA.y,texelsWeightsUB.xz);vec3 fetchesWeightsV=vec3(texelsWeightsVA.xz,texelsWeightsVB.y)+vec3(texelsWeightsVA.y,texelsWeightsVB.xz);vec3 fetchesOffsetsU=vec3(texelsWeightsUA.y,texelsWeightsUB.xz)/fetchesWeightsU.xyz+vec3(-2.5,-0.5,1.5);vec3 fetchesOffsetsV=vec3(texelsWeightsVA.y,texelsWeightsVB.xz)/fetchesWeightsV.xyz+vec3(-2.5,-0.5,1.5);fetchesOffsetsU*=shadowMapTextureTexelSize.xxx;fetchesOffsetsV*=shadowMapTextureTexelSize.yyy;vec2 bilinearFetchOrigin=centerOfFetchesInTexelSpace*shadowMapTextureTexelSize.xy;fetchesUV[0]=bilinearFetchOrigin+vec2(fetchesOffsetsU.x,fetchesOffsetsV.x);fetchesUV[1]=bilinearFetchOrigin+vec2(fetchesOffsetsU.y,fetchesOffsetsV.x);fetchesUV[2]=bilinearFetchOrigin+vec2(fetchesOffsetsU.z,fetchesOffsetsV.x);fetchesUV[3]=bilinearFetchOrigin+vec2(fetchesOffsetsU.x,fetchesOffsetsV.y);fetchesUV[4]=bilinearFetchOrigin+vec2(fetchesOffsetsU.y,fetchesOffsetsV.y);fetchesUV[5]=bilinearFetchOrigin+vec2(fetchesOffsetsU.z,fetchesOffsetsV.y);fetchesUV[6]=bilinearFetchOrigin+vec2(fetchesOffsetsU.x,fetchesOffsetsV.z);fetchesUV[7]=bilinearFetchOrigin+vec2(fetchesOffsetsU.y,fetchesOffsetsV.z);fetchesUV[8]=bilinearFetchOrigin+vec2(fetchesOffsetsU.z,fetchesOffsetsV.z);fetchesWeights[0]=fetchesWeightsU.x*fetchesWeightsV.x;fetchesWeights[1]=fetchesWeightsU.y*fetchesWeightsV.x;fetchesWeights[2]=fetchesWeightsU.z*fetchesWeightsV.x;fetchesWeights[3]=fetchesWeightsU.x*fetchesWeightsV.y;fetchesWeights[4]=fetchesWeightsU.y*fetchesWeightsV.y;fetchesWeights[5]=fetchesWeightsU.z*fetchesWeightsV.y;fetchesWeights[6]=fetchesWeightsU.x*fetchesWeightsV.z;fetchesWeights[7]=fetchesWeightsU.y*fetchesWeightsV.z;fetchesWeights[8]=fetchesWeightsU.z*fetchesWeightsV.z;}"; // eslint-disable-line
 
@@ -18927,8 +18927,9 @@ var unlitVs = "#define GLSLIFY 1\n#include <common>\n#include <common_vert>\n#in
             }
             return;
         }
+        ++hierarchy;
         for(var k1 in cacheMap){
-            this._recursiveDestroy(++hierarchy, cacheMap[k1]);
+            this._recursiveDestroy(hierarchy, cacheMap[k1]);
         }
     };
     _proto._resizeCacheMapHierarchy = function _resizeCacheMapHierarchy(cacheMap, hierarchy, currentHierarchy, increaseHierarchy) {
@@ -20957,6 +20958,10 @@ __decorate([
         /** The splits of two cascade distribution. */ _this.shadowTwoCascadeSplits = 1.0 / 3.0;
         /** The splits of four cascade distribution. */ _this.shadowFourCascadeSplits = new Vector3(1.0 / 15, 3.0 / 15.0, 7.0 / 15.0);
         /** Max Shadow distance. */ _this.shadowDistance = 50;
+        /**
+   * Last shadow fade distance in percentage, range [0,1].
+   * @remarks Value 0 is used for no shadow fade.
+   */ _this.shadowFadeBorder = 0.1;
         /* @internal */ _this._lightManager = new LightManager();
         /* @internal */ _this._componentsManager = new ComponentsManager();
         /** @internal */ _this._isActiveInEngine = false;
@@ -21581,47 +21586,66 @@ __decorate([
     DepthTextureMode[DepthTextureMode[/* Generate depth texture by pre-pass rendering. */ "PrePass"] = 1] = "PrePass";
 })(DepthTextureMode || (DepthTextureMode = {}));
 
-var passNum = 0;
 /**
- * RenderPass.
- */ var RenderPass = /*#__PURE__*/ function() {
-    function RenderPass(name, priority, renderTarget, replaceMaterial, mask) {
-        if (name === void 0) name = "RENDER_PASS" + passNum++;
-        if (priority === void 0) priority = 0;
-        if (renderTarget === void 0) renderTarget = null;
-        if (replaceMaterial === void 0) replaceMaterial = null;
-        if (mask === void 0) mask = null;
-        this.name = name;
-        this.enabled = true;
-        this.priority = priority;
-        this.renderTarget = renderTarget;
-        this.replaceMaterial = replaceMaterial;
-        this.mask = mask || Layer.Everything;
-        this.renderOverride = false; // If renderOverride is set to true, you need to implement the render method
-    }
-    var _proto = RenderPass.prototype;
-    /**
-   * Rendering callback, will be executed if renderOverride is set to true.
-   * @param camera - Camera
-   * @param opaqueQueue - Opaque queue
-   * @param alphaTestQueue - Alpha test queue
-   * @param transparentQueue - Transparent queue
-   */ _proto.render = function render(camera, opaqueQueue, alphaTestQueue, transparentQueue) {};
+ * PipelinePass is a base class for all pipeline passes.
+ */ var PipelinePass = function PipelinePass(engine) {
+    this._engine = engine;
+};
+
+/**
+ * @internal
+ */ var PipelineUtils = /*#__PURE__*/ function() {
+    function PipelineUtils() {}
     /**
-   * Post rendering callback.
-   * @param camera - Camera
-   * @param opaqueQueue - Opaque queue
-   * @param alphaTestQueue - Alpha test queue
-   * @param transparentQueue - Transparent queue
-   */ _proto.preRender = function preRender(camera, opaqueQueue, alphaTestQueue, transparentQueue) {};
+   * Recreate texture if needed.
+   * @param engine - Engine
+   * @param currentTexture - Current texture
+   * @param width - Need texture width
+   * @param height - Need texture height
+   * @param format - Need texture format
+   * @param mipmap - Need texture mipmap
+   * @returns Texture
+   */ PipelineUtils.recreateTextureIfNeeded = function recreateTextureIfNeeded(engine, currentTexture, width, height, format, mipmap) {
+        if (currentTexture) {
+            if (currentTexture.width !== width || currentTexture.height !== height || currentTexture.format !== format || currentTexture.mipmapCount > 1 !== mipmap) {
+                currentTexture.destroy();
+                var texture = new Texture2D(engine, width, height, format, mipmap);
+                texture.isGCIgnored = true;
+                return texture;
+            } else {
+                return currentTexture;
+            }
+        } else {
+            var texture1 = new Texture2D(engine, width, height, format, mipmap);
+            texture1.isGCIgnored = true;
+            return texture1;
+        }
+    };
     /**
-   * Post rendering callback.
-   * @param camera - Camera
-   * @param opaqueQueue - Opaque queue
-   * @param alphaTestQueue - Alpha test queue
-   * @param transparentQueue - Transparent queue
-   */ _proto.postRender = function postRender(camera, opaqueQueue, alphaTestQueue, transparentQueue) {};
-    return RenderPass;
+   * Recreate render target if needed.
+   * @param engine - Engine
+   * @param currentRenderTarget - Current render target
+   * @param width - Need render target width
+   * @param height - Need render target height
+   * @param colorFormat - Need render target color format
+   * @param depthFormat - Need render target depth format
+   * @param mipmap - Need render target mipmap
+   * @returns Render target
+   */ PipelineUtils.recreateRenderTargetIfNeeded = function recreateRenderTargetIfNeeded(engine, currentRenderTarget, width, height, colorFormat, depthFormat, mipmap) {
+        var _currentRenderTarget, _currentRenderTarget1;
+        var currentColorTexture = (_currentRenderTarget = currentRenderTarget) == null ? void 0 : _currentRenderTarget.getColorTexture(0);
+        var currentDepthTexture = (_currentRenderTarget1 = currentRenderTarget) == null ? void 0 : _currentRenderTarget1.depthTexture;
+        var colorTexture = colorFormat ? PipelineUtils.recreateTextureIfNeeded(engine, currentColorTexture, width, height, colorFormat, mipmap) : null;
+        var depthTexture = depthFormat ? PipelineUtils.recreateTextureIfNeeded(engine, currentDepthTexture, width, height, depthFormat, mipmap) : null;
+        if (currentColorTexture !== colorTexture || currentDepthTexture !== depthTexture) {
+            var _currentRenderTarget2;
+            (_currentRenderTarget2 = currentRenderTarget) == null ? void 0 : _currentRenderTarget2.destroy();
+            currentRenderTarget = new RenderTarget(engine, width, height, colorTexture, depthTexture);
+            currentRenderTarget.isGCIgnored = true;
+        }
+        return currentRenderTarget;
+    };
+    return PipelineUtils;
 }();
 
 /**
@@ -21928,60 +21952,47 @@ var passNum = 0;
     return RenderQueue;
 }();
 
+var passNum = 0;
 /**
- * @internal
- */ var PipelineUtils = /*#__PURE__*/ function() {
-    function PipelineUtils() {}
+ * RenderPass.
+ */ var RenderPass = /*#__PURE__*/ function() {
+    function RenderPass(name, priority, renderTarget, replaceMaterial, mask) {
+        if (name === void 0) name = "RENDER_PASS" + passNum++;
+        if (priority === void 0) priority = 0;
+        if (renderTarget === void 0) renderTarget = null;
+        if (replaceMaterial === void 0) replaceMaterial = null;
+        if (mask === void 0) mask = null;
+        this.name = name;
+        this.enabled = true;
+        this.priority = priority;
+        this.renderTarget = renderTarget;
+        this.replaceMaterial = replaceMaterial;
+        this.mask = mask || Layer.Everything;
+        this.renderOverride = false; // If renderOverride is set to true, you need to implement the render method
+    }
+    var _proto = RenderPass.prototype;
     /**
-   * Recreate texture if needed.
-   * @param engine - Engine
-   * @param currentTexture - Current texture
-   * @param width - Need texture width
-   * @param height - Need texture height
-   * @param format - Need texture format
-   * @param mipmap - Need texture mipmap
-   * @returns Texture
-   */ PipelineUtils.recreateTextureIfNeeded = function recreateTextureIfNeeded(engine, currentTexture, width, height, format, mipmap) {
-        if (currentTexture) {
-            if (currentTexture.width !== width || currentTexture.height !== height || currentTexture.format !== format || currentTexture.mipmapCount > 1 !== mipmap) {
-                currentTexture.destroy();
-                var texture = new Texture2D(engine, width, height, format, mipmap);
-                texture.isGCIgnored = true;
-                return texture;
-            } else {
-                return currentTexture;
-            }
-        } else {
-            var texture1 = new Texture2D(engine, width, height, format, mipmap);
-            texture1.isGCIgnored = true;
-            return texture1;
-        }
-    };
+   * Rendering callback, will be executed if renderOverride is set to true.
+   * @param camera - Camera
+   * @param opaqueQueue - Opaque queue
+   * @param alphaTestQueue - Alpha test queue
+   * @param transparentQueue - Transparent queue
+   */ _proto.render = function render(camera, opaqueQueue, alphaTestQueue, transparentQueue) {};
     /**
-   * Recreate render target if needed.
-   * @param engine - Engine
-   * @param currentRenderTarget - Current render target
-   * @param width - Need render target width
-   * @param height - Need render target height
-   * @param colorFormat - Need render target color format
-   * @param depthFormat - Need render target depth format
-   * @param mipmap - Need render target mipmap
-   * @returns Render target
-   */ PipelineUtils.recreateRenderTargetIfNeeded = function recreateRenderTargetIfNeeded(engine, currentRenderTarget, width, height, colorFormat, depthFormat, mipmap) {
-        var _currentRenderTarget, _currentRenderTarget1;
-        var currentColorTexture = (_currentRenderTarget = currentRenderTarget) == null ? void 0 : _currentRenderTarget.getColorTexture(0);
-        var currentDepthTexture = (_currentRenderTarget1 = currentRenderTarget) == null ? void 0 : _currentRenderTarget1.depthTexture;
-        var colorTexture = colorFormat ? PipelineUtils.recreateTextureIfNeeded(engine, currentColorTexture, width, height, colorFormat, mipmap) : null;
-        var depthTexture = depthFormat ? PipelineUtils.recreateTextureIfNeeded(engine, currentDepthTexture, width, height, depthFormat, mipmap) : null;
-        if (currentColorTexture !== colorTexture || currentDepthTexture !== depthTexture) {
-            var _currentRenderTarget2;
-            (_currentRenderTarget2 = currentRenderTarget) == null ? void 0 : _currentRenderTarget2.destroy();
-            currentRenderTarget = new RenderTarget(engine, width, height, colorTexture, depthTexture);
-            currentRenderTarget.isGCIgnored = true;
-        }
-        return currentRenderTarget;
-    };
-    return PipelineUtils;
+   * Post rendering callback.
+   * @param camera - Camera
+   * @param opaqueQueue - Opaque queue
+   * @param alphaTestQueue - Alpha test queue
+   * @param transparentQueue - Transparent queue
+   */ _proto.preRender = function preRender(camera, opaqueQueue, alphaTestQueue, transparentQueue) {};
+    /**
+   * Post rendering callback.
+   * @param camera - Camera
+   * @param opaqueQueue - Opaque queue
+   * @param alphaTestQueue - Alpha test queue
+   * @param transparentQueue - Transparent queue
+   */ _proto.postRender = function postRender(camera, opaqueQueue, alphaTestQueue, transparentQueue) {};
+    return RenderPass;
 }();
 
 /**
@@ -22249,6 +22260,26 @@ var /**
         var offset = cascadeIndex * 16;
         Utils._floatMatrixMultiply(sliceMatrix, outShadowMatrices, offset, outShadowMatrices, offset);
     };
+    /**
+   * Extract scale and bias from a fade distance to achieve a linear fading of the fade distance.
+   */ ShadowUtils.getScaleAndBiasForLinearDistanceFade = function getScaleAndBiasForLinearDistanceFade(fadeDistance, border, outInfo) {
+        // (P^2-N^2)/(F^2-N^2)
+        // To avoid division from zero
+        // This values ensure that fade within cascade will be 0 and outside 1
+        if (border < 0.0001) {
+            var multiplier = 1000; // To avoid blending if difference is in fractions
+            outInfo.z = multiplier;
+            outInfo.w = -fadeDistance * multiplier;
+            return;
+        }
+        border = 1 - border;
+        border *= border;
+        // Fade with distance calculation is just a linear fade from 90% of fade distance to fade distance. 90% arbitrarily chosen but should work well enough.
+        var distanceFadeNear = border * fadeDistance;
+        var fadeRange = fadeDistance - distanceFadeNear;
+        outInfo.z = 1.0 / fadeRange;
+        outInfo.w = -distanceFadeNear / fadeRange;
+    };
     return ShadowUtils;
 }();
 (function() {
@@ -22493,12 +22524,6 @@ var /**
     ShadowUtils.atlasBorderSize = 4.0;
 })();
 
-/**
- * PipelinePass is a base class for all pipeline passes.
- */ var PipelinePass = function PipelinePass(engine) {
-    this._engine = engine;
-};
-
 /**
  * Cascade shadow caster pass.
  */ var CascadedShadowCasterPass = /*#__PURE__*/ function(PipelinePass1) {
@@ -22511,11 +22536,10 @@ var /**
         _this._shadowSliceData = new ShadowSliceData();
         _this._lightUp = new Vector3();
         _this._lightSide = new Vector3();
-        _this._existShadowMap = false;
         _this._splitBoundSpheres = new Float32Array(CascadedShadowCasterPass._maxCascades * 4);
         /** The end is project precision problem in shader. */ _this._shadowMatrices = new Float32Array((CascadedShadowCasterPass._maxCascades + 1) * 16);
-        // strength, null, lightIndex
-        _this._shadowInfos = new Vector3();
+        // intensity, null, fadeScale, fadeBias
+        _this._shadowInfos = new Vector4();
         _this._viewportOffsets = [
             new Vector2(),
             new Vector2(),
@@ -22531,14 +22555,12 @@ var /**
     /**
    * @internal
    */ _proto.onRender = function onRender(context) {
+        var light = this._camera.scene._lightManager._sunlight;
         this._updateShadowSettings();
-        this._existShadowMap = false;
-        this._renderDirectShadowMap(context);
-        if (this._existShadowMap) {
-            this._updateReceiversShaderData();
-        }
+        this._renderDirectShadowMap(context, light);
+        this._updateReceiversShaderData(light);
     };
-    _proto._renderDirectShadowMap = function _renderDirectShadowMap(context) {
+    _proto._renderDirectShadowMap = function _renderDirectShadowMap(context, light) {
         var _this = this, engine = _this._engine, camera = _this._camera, viewports = _this._viewportOffsets, shadowSliceData = _this._shadowSliceData, splitBoundSpheres = _this._splitBoundSpheres, shadowMatrices = _this._shadowMatrices;
         var _camera__renderPipeline__cullingResults = camera._renderPipeline._cullingResults, opaqueQueue = _camera__renderPipeline__cullingResults.opaqueQueue, alphaTestQueue = _camera__renderPipeline__cullingResults.alphaTestQueue, transparentQueue = _camera__renderPipeline__cullingResults.transparentQueue;
         var scene = camera.scene;
@@ -22552,91 +22574,87 @@ var /**
         var lightUp = this._lightUp;
         var lightSide = this._lightSide;
         var lightForward = shadowSliceData.virtualCamera.forward;
-        var light = scene._lightManager._sunlight;
-        if (light) {
-            var shadowFar = Math.min(camera.scene.shadowDistance, camera.farClipPlane);
-            this._getCascadesSplitDistance(shadowFar);
-            // Prepare render target
-            var _this__shadowMapSize = this._shadowMapSize, width = _this__shadowMapSize.z, height = _this__shadowMapSize.w;
-            var format = this._shadowMapFormat;
-            var renderTarget;
-            var shadowTexture;
-            if (this._supportDepthTexture) {
-                renderTarget = PipelineUtils.recreateRenderTargetIfNeeded(engine, this._renderTarget, width, height, null, format, false);
-                shadowTexture = renderTarget.depthTexture;
-            } else {
-                renderTarget = PipelineUtils.recreateRenderTargetIfNeeded(engine, this._renderTarget, width, height, format, null, false);
-                shadowTexture = renderTarget.getColorTexture(0);
-            }
-            shadowTexture.wrapModeU = shadowTexture.wrapModeV = TextureWrapMode.Clamp;
-            if (engine._hardwareRenderer._isWebGL2) {
-                shadowTexture.depthCompareFunction = TextureDepthCompareFunction.Less;
-            }
-            this._renderTarget = renderTarget;
-            this._depthTexture = shadowTexture;
-            // @todo: shouldn't set viewport and scissor in activeRenderTarget
-            rhi.activeRenderTarget(renderTarget, CascadedShadowCasterPass._viewport, 0);
-            if (this._supportDepthTexture) {
-                rhi.clearRenderTarget(engine, CameraClearFlags.Depth, null);
-            } else {
-                rhi.clearRenderTarget(engine, CameraClearFlags.All, CascadedShadowCasterPass._clearColor);
-            }
-            this._shadowInfos.x = light.shadowStrength;
-            this._shadowInfos.z = 0; // @todo: sun light index always 0
-            // prepare light and camera direction
-            Matrix.rotationQuaternion(light.entity.transform.worldRotationQuaternion, lightWorld);
-            lightSide.set(lightWorldE[0], lightWorldE[1], lightWorldE[2]);
-            lightUp.set(lightWorldE[4], lightWorldE[5], lightWorldE[6]);
-            lightForward.set(-lightWorldE[8], -lightWorldE[9], -lightWorldE[10]);
-            var cameraForward = CascadedShadowCasterPass._tempVector;
-            cameraForward.copyFrom(camera.entity.transform.worldForward);
-            var shadowTileResolution = this._shadowTileResolution;
-            for(var j = 0; j < shadowCascades; j++){
-                ShadowUtils.getBoundSphereByFrustum(splitDistance[j], splitDistance[j + 1], camera, cameraForward, shadowSliceData);
-                ShadowUtils.getDirectionLightShadowCullPlanes(camera._frustum, splitDistance[j], camera.nearClipPlane, lightForward, shadowSliceData);
-                ShadowUtils.getDirectionalLightMatrices(lightUp, lightSide, lightForward, j, light.shadowNearPlane, shadowTileResolution, shadowSliceData, shadowMatrices);
-                if (shadowCascades > 1) {
-                    ShadowUtils.applySliceTransform(shadowTileResolution, width, height, j, this._viewportOffsets[j], shadowMatrices);
-                }
-                this._updateSingleShadowCasterShaderData(light, shadowSliceData, context);
-                // upload pre-cascade infos.
-                var center = boundSphere.center;
-                var radius = boundSphere.radius;
-                var offset = j * 4;
-                splitBoundSpheres[offset] = center.x;
-                splitBoundSpheres[offset + 1] = center.y;
-                splitBoundSpheres[offset + 2] = center.z;
-                splitBoundSpheres[offset + 3] = radius * radius;
-                opaqueQueue.clear();
-                alphaTestQueue.clear();
-                transparentQueue.clear();
-                var renderers = componentsManager._renderers;
-                var elements = renderers._elements;
-                for(var k = renderers.length - 1; k >= 0; --k){
-                    ShadowUtils.shadowCullFrustum(context, light, elements[k], shadowSliceData);
-                }
-                if (opaqueQueue.elements.length || alphaTestQueue.elements.length) {
-                    opaqueQueue.sort(RenderQueue._compareFromNearToFar);
-                    alphaTestQueue.sort(RenderQueue._compareFromNearToFar);
-                    var _viewports_j = viewports[j], x = _viewports_j.x, y = _viewports_j.y;
-                    rhi.setGlobalDepthBias(1.0, 1.0);
-                    rhi.viewport(x, y, shadowTileResolution, shadowTileResolution);
-                    // for no cascade is for the edge,for cascade is for the beyond maxCascade pixel can use (0,0,0) trick sample the shadowMap
-                    rhi.scissor(x + 1, y + 1, shadowTileResolution - 2, shadowTileResolution - 2);
-                    engine._renderCount++;
-                    opaqueQueue.render(camera, Layer.Everything, PipelineStage.ShadowCaster);
-                    alphaTestQueue.render(camera, Layer.Everything, PipelineStage.ShadowCaster);
-                    rhi.setGlobalDepthBias(0, 0);
-                }
-            }
-            this._existShadowMap = true;
-        }
-    };
-    _proto._updateReceiversShaderData = function _updateReceiversShaderData() {
-        var scene = this._camera.scene;
+        // Prepare render target
+        var _this__shadowMapSize = this._shadowMapSize, width = _this__shadowMapSize.z, height = _this__shadowMapSize.w;
+        var format = this._shadowMapFormat;
+        var renderTarget;
+        var shadowTexture;
+        if (this._supportDepthTexture) {
+            renderTarget = PipelineUtils.recreateRenderTargetIfNeeded(engine, this._renderTarget, width, height, null, format, false);
+            shadowTexture = renderTarget.depthTexture;
+        } else {
+            renderTarget = PipelineUtils.recreateRenderTargetIfNeeded(engine, this._renderTarget, width, height, format, null, false);
+            shadowTexture = renderTarget.getColorTexture(0);
+        }
+        shadowTexture.wrapModeU = shadowTexture.wrapModeV = TextureWrapMode.Clamp;
+        if (engine._hardwareRenderer._isWebGL2) {
+            shadowTexture.depthCompareFunction = TextureDepthCompareFunction.Less;
+        }
+        this._renderTarget = renderTarget;
+        this._depthTexture = shadowTexture;
+        // @todo: shouldn't set viewport and scissor in activeRenderTarget
+        rhi.activeRenderTarget(renderTarget, CascadedShadowCasterPass._viewport, 0);
+        if (this._supportDepthTexture) {
+            rhi.clearRenderTarget(engine, CameraClearFlags.Depth, null);
+        } else {
+            rhi.clearRenderTarget(engine, CameraClearFlags.All, CascadedShadowCasterPass._clearColor);
+        }
+        // prepare light and camera direction
+        Matrix.rotationQuaternion(light.entity.transform.worldRotationQuaternion, lightWorld);
+        lightSide.set(lightWorldE[0], lightWorldE[1], lightWorldE[2]);
+        lightUp.set(lightWorldE[4], lightWorldE[5], lightWorldE[6]);
+        lightForward.set(-lightWorldE[8], -lightWorldE[9], -lightWorldE[10]);
+        var cameraForward = CascadedShadowCasterPass._tempVector;
+        cameraForward.copyFrom(camera.entity.transform.worldForward);
+        var shadowTileResolution = this._shadowTileResolution;
+        for(var j = 0; j < shadowCascades; j++){
+            ShadowUtils.getBoundSphereByFrustum(splitDistance[j], splitDistance[j + 1], camera, cameraForward, shadowSliceData);
+            ShadowUtils.getDirectionLightShadowCullPlanes(camera._frustum, splitDistance[j], camera.nearClipPlane, lightForward, shadowSliceData);
+            ShadowUtils.getDirectionalLightMatrices(lightUp, lightSide, lightForward, j, light.shadowNearPlane, shadowTileResolution, shadowSliceData, shadowMatrices);
+            if (shadowCascades > 1) {
+                ShadowUtils.applySliceTransform(shadowTileResolution, width, height, j, this._viewportOffsets[j], shadowMatrices);
+            }
+            this._updateSingleShadowCasterShaderData(light, shadowSliceData, context);
+            // upload pre-cascade infos.
+            var center = boundSphere.center;
+            var radius = boundSphere.radius;
+            var offset = j * 4;
+            splitBoundSpheres[offset] = center.x;
+            splitBoundSpheres[offset + 1] = center.y;
+            splitBoundSpheres[offset + 2] = center.z;
+            splitBoundSpheres[offset + 3] = radius * radius;
+            opaqueQueue.clear();
+            alphaTestQueue.clear();
+            transparentQueue.clear();
+            var renderers = componentsManager._renderers;
+            var elements = renderers._elements;
+            for(var k = renderers.length - 1; k >= 0; --k){
+                ShadowUtils.shadowCullFrustum(context, light, elements[k], shadowSliceData);
+            }
+            if (opaqueQueue.elements.length || alphaTestQueue.elements.length) {
+                opaqueQueue.sort(RenderQueue._compareFromNearToFar);
+                alphaTestQueue.sort(RenderQueue._compareFromNearToFar);
+                var _viewports_j = viewports[j], x = _viewports_j.x, y = _viewports_j.y;
+                rhi.setGlobalDepthBias(1.0, 1.0);
+                rhi.viewport(x, y, shadowTileResolution, shadowTileResolution);
+                // for no cascade is for the edge,for cascade is for the beyond maxCascade pixel can use (0,0,0) trick sample the shadowMap
+                rhi.scissor(x + 1, y + 1, shadowTileResolution - 2, shadowTileResolution - 2);
+                engine._renderCount++;
+                opaqueQueue.render(camera, Layer.Everything, PipelineStage.ShadowCaster);
+                alphaTestQueue.render(camera, Layer.Everything, PipelineStage.ShadowCaster);
+                rhi.setGlobalDepthBias(0, 0);
+            }
+        }
+    };
+    _proto._updateReceiversShaderData = function _updateReceiversShaderData(light) {
+        var camera = this._camera;
+        var scene = camera.scene;
         var splitBoundSpheres = this._splitBoundSpheres;
         var shadowMatrices = this._shadowMatrices;
         var shadowCascades = scene.shadowCascades;
+        var shadowFar = Math.min(scene.shadowDistance, camera.farClipPlane);
+        ShadowUtils.getScaleAndBiasForLinearDistanceFade(Math.pow(shadowFar, 2), scene.shadowFadeBorder, this._shadowInfos);
+        this._shadowInfos.x = light.shadowStrength;
         // set zero matrix to project the index out of max cascade
         if (shadowCascades > 1) {
             for(var i = shadowCascades * 4, n = splitBoundSpheres.length; i < n; i++){
@@ -22649,7 +22667,7 @@ var /**
         }
         var shaderData = scene.shaderData;
         shaderData.setFloatArray(CascadedShadowCasterPass._shadowMatricesProperty, this._shadowMatrices);
-        shaderData.setVector3(CascadedShadowCasterPass._shadowInfosProperty, this._shadowInfos);
+        shaderData.setVector4(CascadedShadowCasterPass._shadowInfosProperty, this._shadowInfos);
         shaderData.setTexture(CascadedShadowCasterPass._shadowMapsProperty, this._depthTexture);
         shaderData.setFloatArray(CascadedShadowCasterPass._shadowSplitSpheresProperty, this._splitBoundSpheres);
         shaderData.setVector4(CascadedShadowCasterPass._shadowMapSize, this._shadowMapSize);
@@ -22685,10 +22703,13 @@ var /**
         return Math.sqrt(radius * radius / denominator);
     };
     _proto._updateShadowSettings = function _updateShadowSettings() {
-        var scene = this._camera.scene;
+        var camera = this._camera;
+        var scene = camera.scene;
         var shadowFormat = ShadowUtils.shadowDepthFormat(scene.shadowResolution, this._supportDepthTexture);
         var shadowResolution = ShadowUtils.shadowResolution(scene.shadowResolution);
         var shadowCascades = scene.shadowCascades;
+        var shadowFar = Math.min(scene.shadowDistance, camera.farClipPlane);
+        this._getCascadesSplitDistance(shadowFar);
         if (shadowFormat !== this._shadowMapFormat || shadowResolution !== this._shadowMapResolution || shadowCascades !== this._shadowCascadeMode) {
             this._shadowMapFormat = shadowFormat;
             this._shadowMapResolution = shadowResolution;
@@ -23869,6 +23890,7 @@ var MultiExecutor = /*#__PURE__*/ function() {
    * @param obj - class object
    */ Loader.registerClass = function registerClass(className, classDefine) {
         this._engineObjects[className] = classDefine;
+        this._classNameMap.set(classDefine, className);
     };
     /**
    * Get the class object by class name.
@@ -23877,11 +23899,21 @@ var MultiExecutor = /*#__PURE__*/ function() {
    */ Loader.getClass = function getClass(className) {
         return this._engineObjects[className];
     };
+    /**
+   * Get the class name by class object.
+   * @param obj - class object
+   * @returns class name
+   */ Loader.getClassName = function getClassName(obj) {
+        return this._classNameMap.get(obj);
+    };
     return Loader;
 }();
 (function() {
     Loader._engineObjects = {};
 })();
+(function() {
+    Loader._classNameMap = new Map();
+})();
 
 /**
  * Alpha blend mode.
@@ -27651,7 +27683,7 @@ __decorate([
                 this._clip = clip;
                 this._clipEndTime = Math.min(this._clipEndTime, 1);
                 this._onClipChanged();
-                clip._updateFlagManager.addListener(this._onClipChanged);
+                clip && clip._updateFlagManager.addListener(this._onClipChanged);
             }
         },
         {
@@ -28358,6 +28390,7 @@ __decorate([
     ParticleRandomSubSeeds[ParticleRandomSubSeeds["RotationOverLifetime"] = 0x40eb95e4] = "RotationOverLifetime";
     ParticleRandomSubSeeds[ParticleRandomSubSeeds["TextureSheetAnimation"] = 0xbc524e5] = "TextureSheetAnimation";
     ParticleRandomSubSeeds[ParticleRandomSubSeeds["Shape"] = 0xaf502044] = "Shape";
+    ParticleRandomSubSeeds[ParticleRandomSubSeeds["GravityModifier"] = 0xa47b8c4d] = "GravityModifier";
 })(ParticleRandomSubSeeds || (ParticleRandomSubSeeds = {}));
 
 /**
@@ -29071,6 +29104,7 @@ var MainModule = /*#__PURE__*/ function() {
         /** @internal */ this._startColorRand = new Rand(0, ParticleRandomSubSeeds.StartColor);
         /** @internal */ this._startSizeRand = new Rand(0, ParticleRandomSubSeeds.StartSize);
         /** @internal */ this._startRotationRand = new Rand(0, ParticleRandomSubSeeds.StartRotation);
+        this._gravityModifierRand = new Rand(0, ParticleRandomSubSeeds.GravityModifier);
         this._gravity = new Vector3();
         this._generator = generator;
     }
@@ -29131,7 +29165,7 @@ var MainModule = /*#__PURE__*/ function() {
                 break;
         }
         var particleGravity = this._gravity;
-        var gravityModifierValue = this.gravityModifier.evaluate(undefined, undefined);
+        var gravityModifierValue = this.gravityModifier.evaluate(undefined, this._gravityModifierRand.random());
         Vector3.scale(renderer.scene.physics.gravity, gravityModifierValue, particleGravity);
         shaderData.setVector3(MainModule._gravity, particleGravity);
         shaderData.setInt(MainModule._simulationSpace, this.simulationSpace);
@@ -29250,6 +29284,9 @@ __decorate([
 __decorate([
     ignoreClone
 ], MainModule.prototype, "_startRotationRand", void 0);
+__decorate([
+    ignoreClone
+], MainModule.prototype, "_gravityModifierRand", void 0);
 __decorate([
     ignoreClone
 ], MainModule.prototype, "_generator", void 0);
@@ -30579,9 +30616,9 @@ __decorate([
     _inherits(BoxShape, BaseShape1);
     function BoxShape() {
         var _this;
-        _this = BaseShape1.call(this) || this;
-        /** The size of the box. */ _this.size = new Vector3(1, 1, 1);
+        _this = BaseShape1.apply(this, arguments) || this;
         _this.shapeType = ParticleShapeType.Box;
+        /** The size of the box. */ _this.size = new Vector3(1, 1, 1);
         return _this;
     }
     var _proto = BoxShape.prototype;
@@ -30618,12 +30655,12 @@ __decorate([
     _inherits(CircleShape, BaseShape1);
     function CircleShape() {
         var _this;
-        _this = BaseShape1.call(this) || this;
+        _this = BaseShape1.apply(this, arguments) || this;
+        _this.shapeType = ParticleShapeType.Circle;
         /** Radius of the shape to emit particles from. */ _this.radius = 1.0;
         /** Angle of the circle arc to emit particles from. */ _this.arc = 360.0;
         /** The mode to generate particles around the arc. */ _this.arcMode = ParticleShapeArcMode.Random;
         /** The speed of complete 360 degree rotation. */ _this.arcSpeed = 1.0;
-        _this.shapeType = ParticleShapeType.Circle;
         return _this;
     }
     var _proto = CircleShape.prototype;
@@ -30659,12 +30696,12 @@ __decorate([
     _inherits(ConeShape, BaseShape1);
     function ConeShape() {
         var _this;
-        _this = BaseShape1.call(this) || this;
+        _this = BaseShape1.apply(this, arguments) || this;
+        _this.shapeType = ParticleShapeType.Cone;
         /** Angle of the cone to emit particles from. */ _this.angle = 25.0;
         /** Radius of the shape to emit particles from. */ _this.radius = 1.0;
         /** Length of the cone to emit particles from. */ _this.length = 5.0;
         /** Cone emitter type. */ _this.emitType = /** Emit particles from the base of the cone. */ 0;
-        _this.shapeType = ParticleShapeType.Cone;
         return _this;
     }
     var _proto = ConeShape.prototype;
@@ -30724,9 +30761,9 @@ var ConeEmitType;
     _inherits(HemisphereShape, BaseShape1);
     function HemisphereShape() {
         var _this;
-        _this = BaseShape1.call(this) || this;
-        /** Radius of the shape to emit particles from. */ _this.radius = 1.0;
+        _this = BaseShape1.apply(this, arguments) || this;
         _this.shapeType = ParticleShapeType.Hemisphere;
+        /** Radius of the shape to emit particles from. */ _this.radius = 1.0;
         return _this;
     }
     var _proto = HemisphereShape.prototype;
@@ -30749,9 +30786,9 @@ var ConeEmitType;
     _inherits(SphereShape, BaseShape1);
     function SphereShape() {
         var _this;
-        _this = BaseShape1.call(this) || this;
-        /** Radius of the shape to emit particles from. */ _this.radius = 1.0;
+        _this = BaseShape1.apply(this, arguments) || this;
         _this.shapeType = ParticleShapeType.Sphere;
+        /** Radius of the shape to emit particles from. */ _this.radius = 1.0;
         return _this;
     }
     var _proto = SphereShape.prototype;
@@ -31124,5 +31161,5 @@ var cacheDir = new Vector3();
     return CubeProbe;
 }(Probe);
 
-export { AmbientLight, AnimationArrayCurve, AnimationBoolCurve, AnimationClip, AnimationClipCurveBinding, AnimationColorCurve, AnimationCurve, AnimationEvent, AnimationFloatArrayCurve, AnimationFloatCurve, AnimationQuaternionCurve, AnimationRectCurve, AnimationRefCurve, AnimationStringCurve, AnimationVector2Curve, AnimationVector3Curve, AnimationVector4Curve, Animator, AnimatorConditionMode, AnimatorController, AnimatorControllerLayer, AnimatorCullingMode, AnimatorLayerBlendingMode, AnimatorLayerMask, AnimatorState, AnimatorStateMachine, AnimatorStateTransition, AssetPromise, AssetType, Background, BackgroundMode, BackgroundTextureFillMode, BaseMaterial, Basic2DBatcher, BasicRenderPipeline, BlendFactor, BlendMode, BlendOperation, BlendShape, BlendShapeFrame, BlendState, BlinnPhongMaterial, BoolUpdateFlag, BoxColliderShape, BoxShape, Buffer, BufferBindFlag, BufferMesh, BufferUsage, BufferUtil, Burst, Camera, CameraClearFlags, CameraType, Canvas, CapsuleColliderShape, CharacterController, CircleShape, CloneManager, Collider, ColliderShape, ColliderShapeUpAxis, CollisionDetectionMode, ColorOverLifetimeModule, ColorSpace, ColorWriteMask, CompareFunction, Component, ConeEmitType, ConeShape, ContentRestorer, ControllerCollisionFlag, ControllerNonWalkableMode, CubeProbe, CullMode, CurveKey, DataType, DependentMode, DepthState, DepthTextureMode, DiffuseMode, DirectLight, DynamicCollider, DynamicColliderConstraints, EmissionModule, Engine, EngineObject, Entity, EventDispatcher, FixedJoint, FogMode, Font, FontStyle, GLCapabilityType, GradientAlphaKey, GradientColorKey, HemisphereShape, HingeJoint, HitResult, IndexBufferBinding, IndexFormat, InputManager, InterpolationType, Joint, JointLimits, JointMotor, Keyframe, Keys, Layer, Light, Loader, Logger, MainModule, Material, Mesh, MeshRenderer, MeshTopology, ModelMesh, OverflowMode, PBRBaseMaterial, PBRMaterial, PBRSpecularMaterial, ParticleCompositeCurve, ParticleCompositeGradient, ParticleCurve, ParticleCurveMode, ParticleGenerator, ParticleGradient, ParticleGradientMode, ParticleMaterial, ParticleRenderMode, ParticleRenderer, ParticleScaleMode, ParticleShapeArcMode, ParticleSimulationSpace, ParticleStopMode, PhysicsMaterial, PhysicsMaterialCombineMode, PhysicsScene, PipelineStage, PlaneColliderShape, Platform, PointLight, Pointer, PointerButton, PointerPhase, Primitive, PrimitiveMesh, Probe, RasterState, ReferResource, RenderBufferDepthFormat, RenderFace, RenderPass, RenderQueue, RenderQueueType, RenderState, RenderStateElementKey as RenderStateDataKey, RenderTarget, RenderTargetBlendState, Renderer, ResourceManager, RotationOverLifetimeModule, Scene, SceneManager, Script, SetDataOptions, Shader, ShaderData, ShaderFactory, ShaderMacro, ShaderMacroCollection, ShaderPass, ShaderProperty, ShaderPropertyType, ShaderTagKey, ShadowCascadesMode, ShadowResolution, ShadowType, SizeOverLifetimeModule, Skin, SkinnedMeshRenderer, Sky, SkyBoxMaterial, SkyProceduralMaterial, SphereColliderShape, SphereShape, SpotLight, SpringJoint, Sprite, SpriteAtlas, SpriteDrawMode, SpriteMask, SpriteMaskInteraction, SpriteMaskLayer, SpriteRenderer, SpriteTileMode, StateMachineScript, StaticCollider, StencilOperation, StencilState, SubMesh, SubShader, SunMode, SystemInfo, TextHorizontalAlignment, TextRenderer, TextUtils, TextVerticalAlignment, Texture, Texture2D, Texture2DArray, TextureCoordinate, TextureCube, TextureCubeFace, TextureDepthCompareFunction, TextureFilterMode, TextureFormat, TextureSheetAnimationModule, TextureUsage, TextureWrapMode, Time, TrailMaterial, TrailRenderer, Transform, UnlitMaterial, Utils, VelocityOverLifetimeModule, VertexAttribute, VertexBufferBinding, VertexElement, VertexElementFormat, WrapMode, XRManager, assignmentClone, deepClone, dependentComponents, ignoreClone, request, resourceLoader, shallowClone };
+export { AmbientLight, AnimationArrayCurve, AnimationBoolCurve, AnimationClip, AnimationClipCurveBinding, AnimationColorCurve, AnimationCurve, AnimationEvent, AnimationFloatArrayCurve, AnimationFloatCurve, AnimationQuaternionCurve, AnimationRectCurve, AnimationRefCurve, AnimationStringCurve, AnimationVector2Curve, AnimationVector3Curve, AnimationVector4Curve, Animator, AnimatorConditionMode, AnimatorController, AnimatorControllerLayer, AnimatorCullingMode, AnimatorLayerBlendingMode, AnimatorLayerMask, AnimatorState, AnimatorStateMachine, AnimatorStateTransition, AssetPromise, AssetType, Background, BackgroundMode, BackgroundTextureFillMode, BaseMaterial, Basic2DBatcher, BasicRenderPipeline, BlendFactor, BlendMode, BlendOperation, BlendShape, BlendShapeFrame, BlendState, BlinnPhongMaterial, BoolUpdateFlag, BoxColliderShape, BoxShape, Buffer, BufferBindFlag, BufferMesh, BufferUsage, BufferUtil, Burst, Camera, CameraClearFlags, CameraType, Canvas, CapsuleColliderShape, CharacterController, CircleShape, CloneManager, Collider, ColliderShape, ColliderShapeUpAxis, CollisionDetectionMode, ColorOverLifetimeModule, ColorSpace, ColorWriteMask, CompareFunction, Component, ConeEmitType, ConeShape, ContentRestorer, ControllerCollisionFlag, ControllerNonWalkableMode, CubeProbe, CullMode, CurveKey, DataType, DependentMode, DepthState, DepthTextureMode, DiffuseMode, DirectLight, DynamicCollider, DynamicColliderConstraints, EmissionModule, Engine, EngineObject, Entity, EventDispatcher, FixedJoint, FogMode, Font, FontStyle, GLCapabilityType, GradientAlphaKey, GradientColorKey, HemisphereShape, HingeJoint, HitResult, IndexBufferBinding, IndexFormat, InputManager, InterpolationType, Joint, JointLimits, JointMotor, Keyframe, Keys, Layer, Light, Loader, Logger, MainModule, Material, Mesh, MeshRenderer, MeshTopology, ModelMesh, OverflowMode, PBRBaseMaterial, PBRMaterial, PBRSpecularMaterial, ParticleCompositeCurve, ParticleCompositeGradient, ParticleCurve, ParticleCurveMode, ParticleGenerator, ParticleGradient, ParticleGradientMode, ParticleMaterial, ParticleRenderMode, ParticleRenderer, ParticleScaleMode, ParticleShapeArcMode, ParticleShapeType, ParticleSimulationSpace, ParticleStopMode, PhysicsMaterial, PhysicsMaterialCombineMode, PhysicsScene, PipelineStage, PlaneColliderShape, Platform, PointLight, Pointer, PointerButton, PointerPhase, Primitive, PrimitiveMesh, Probe, RasterState, ReferResource, RenderBufferDepthFormat, RenderFace, RenderPass, RenderQueue, RenderQueueType, RenderState, RenderStateElementKey as RenderStateDataKey, RenderTarget, RenderTargetBlendState, Renderer, ResourceManager, RotationOverLifetimeModule, Scene, SceneManager, Script, SetDataOptions, Shader, ShaderData, ShaderFactory, ShaderMacro, ShaderMacroCollection, ShaderPass, ShaderProperty, ShaderPropertyType, ShaderTagKey, ShadowCascadesMode, ShadowResolution, ShadowType, SizeOverLifetimeModule, Skin, SkinnedMeshRenderer, Sky, SkyBoxMaterial, SkyProceduralMaterial, SphereColliderShape, SphereShape, SpotLight, SpringJoint, Sprite, SpriteAtlas, SpriteDrawMode, SpriteMask, SpriteMaskInteraction, SpriteMaskLayer, SpriteRenderer, SpriteTileMode, StateMachineScript, StaticCollider, StencilOperation, StencilState, SubMesh, SubShader, SunMode, SystemInfo, TextHorizontalAlignment, TextRenderer, TextUtils, TextVerticalAlignment, Texture, Texture2D, Texture2DArray, TextureCoordinate, TextureCube, TextureCubeFace, TextureDepthCompareFunction, TextureFilterMode, TextureFormat, TextureSheetAnimationModule, TextureUsage, TextureWrapMode, Time, TrailMaterial, TrailRenderer, Transform, UnlitMaterial, Utils, VelocityOverLifetimeModule, VertexAttribute, VertexBufferBinding, VertexElement, VertexElementFormat, WrapMode, XRManager, assignmentClone, deepClone, dependentComponents, ignoreClone, request, resourceLoader, shallowClone };
 //# sourceMappingURL=module.js.map