@galacean/engine-core 1.2.0-alpha.3 → 1.2.0-alpha.5

package/dist/main.js

@@ -3292,7 +3292,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
 
@@ -3418,7 +3418,7 @@ var ShaderFactory = /*#__PURE__*/ function() {
                 Logger.error('Shader slice "' + match.trim() + '" not founded.');
                 return "";
             }
-            return ShaderFactory.parseIncludes(replace);
+            return ShaderFactory.parseIncludes(replace, regex);
         };
         return src.replace(regex, replace);
     };
@@ -20962,6 +20962,10 @@ __decorate([
         /** The splits of two cascade distribution. */ _this.shadowTwoCascadeSplits = 1.0 / 3.0;
         /** The splits of four cascade distribution. */ _this.shadowFourCascadeSplits = new engineMath.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;
@@ -21586,47 +21590,66 @@ __decorate([
     DepthTextureMode[DepthTextureMode[/* Generate depth texture by pre-pass rendering. */ "PrePass"] = 1] = "PrePass";
 })(exports.DepthTextureMode || (exports.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 || exports.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;
 }();
 
 /**
@@ -21933,60 +21956,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 || exports.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;
 }();
 
 /**
@@ -22254,6 +22264,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() {
@@ -22498,12 +22528,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) {
@@ -22516,11 +22540,10 @@ var /**
         _this._shadowSliceData = new ShadowSliceData();
         _this._lightUp = new engineMath.Vector3();
         _this._lightSide = new engineMath.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 engineMath.Vector3();
+        // intensity, null, fadeScale, fadeBias
+        _this._shadowInfos = new engineMath.Vector4();
         _this._viewportOffsets = [
             new engineMath.Vector2(),
             new engineMath.Vector2(),
@@ -22536,14 +22559,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;
@@ -22557,91 +22578,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 = exports.TextureWrapMode.Clamp;
-            if (engine._hardwareRenderer._isWebGL2) {
-                shadowTexture.depthCompareFunction = exports.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, exports.CameraClearFlags.Depth, null);
-            } else {
-                rhi.clearRenderTarget(engine, exports.CameraClearFlags.All, CascadedShadowCasterPass._clearColor);
-            }
-            this._shadowInfos.x = light.shadowStrength;
-            this._shadowInfos.z = 0; // @todo: sun light index always 0
-            // prepare light and camera direction
-            engineMath.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, exports.Layer.Everything, exports.PipelineStage.ShadowCaster);
-                    alphaTestQueue.render(camera, exports.Layer.Everything, exports.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 = exports.TextureWrapMode.Clamp;
+        if (engine._hardwareRenderer._isWebGL2) {
+            shadowTexture.depthCompareFunction = exports.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, exports.CameraClearFlags.Depth, null);
+        } else {
+            rhi.clearRenderTarget(engine, exports.CameraClearFlags.All, CascadedShadowCasterPass._clearColor);
+        }
+        // prepare light and camera direction
+        engineMath.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, exports.Layer.Everything, exports.PipelineStage.ShadowCaster);
+                alphaTestQueue.render(camera, exports.Layer.Everything, exports.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++){
@@ -22654,7 +22671,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);
@@ -22690,10 +22707,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;
@@ -23874,6 +23894,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.
@@ -23882,11 +23903,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.
@@ -27656,7 +27687,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);
             }
         },
         {
@@ -28363,6 +28394,7 @@ __decorate([
     ParticleRandomSubSeeds[ParticleRandomSubSeeds["RotationOverLifetime"] = 0x40eb95e4] = "RotationOverLifetime";
     ParticleRandomSubSeeds[ParticleRandomSubSeeds["TextureSheetAnimation"] = 0xbc524e5] = "TextureSheetAnimation";
     ParticleRandomSubSeeds[ParticleRandomSubSeeds["Shape"] = 0xaf502044] = "Shape";
+    ParticleRandomSubSeeds[ParticleRandomSubSeeds["GravityModifier"] = 0xa47b8c4d] = "GravityModifier";
 })(ParticleRandomSubSeeds || (ParticleRandomSubSeeds = {}));
 
 /**
@@ -29076,6 +29108,7 @@ var MainModule = /*#__PURE__*/ function() {
         /** @internal */ this._startColorRand = new engineMath.Rand(0, ParticleRandomSubSeeds.StartColor);
         /** @internal */ this._startSizeRand = new engineMath.Rand(0, ParticleRandomSubSeeds.StartSize);
         /** @internal */ this._startRotationRand = new engineMath.Rand(0, ParticleRandomSubSeeds.StartRotation);
+        this._gravityModifierRand = new engineMath.Rand(0, ParticleRandomSubSeeds.GravityModifier);
         this._gravity = new engineMath.Vector3();
         this._generator = generator;
     }
@@ -29136,7 +29169,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());
         engineMath.Vector3.scale(renderer.scene.physics.gravity, gravityModifierValue, particleGravity);
         shaderData.setVector3(MainModule._gravity, particleGravity);
         shaderData.setInt(MainModule._simulationSpace, this.simulationSpace);
@@ -29255,6 +29288,9 @@ __decorate([
 __decorate([
     ignoreClone
 ], MainModule.prototype, "_startRotationRand", void 0);
+__decorate([
+    ignoreClone
+], MainModule.prototype, "_gravityModifierRand", void 0);
 __decorate([
     ignoreClone
 ], MainModule.prototype, "_generator", void 0);
@@ -30569,14 +30605,14 @@ __decorate([
 
 /**
  * The emission shape.
- */ var ParticleShapeType;
+ */ exports.ParticleShapeType = void 0;
 (function(ParticleShapeType) {
     ParticleShapeType[ParticleShapeType[/** Emit from the volume of a box. */ "Box"] = 0] = "Box";
     ParticleShapeType[ParticleShapeType[/** Emit from a circle. */ "Circle"] = 1] = "Circle";
     ParticleShapeType[ParticleShapeType[/** Emit from the base of a cone. */ "Cone"] = 2] = "Cone";
     ParticleShapeType[ParticleShapeType[/** Emit from a half-sphere. */ "Hemisphere"] = 3] = "Hemisphere";
     ParticleShapeType[ParticleShapeType[/** Emit from a sphere. */ "Sphere"] = 4] = "Sphere";
-})(ParticleShapeType || (ParticleShapeType = {}));
+})(exports.ParticleShapeType || (exports.ParticleShapeType = {}));
 
 /**
  * Particle shape that emits particles from a box.
@@ -30584,9 +30620,9 @@ __decorate([
     _inherits(BoxShape, BaseShape1);
     function BoxShape() {
         var _this;
-        _this = BaseShape1.call(this) || this;
+        _this = BaseShape1.apply(this, arguments) || this;
+        _this.shapeType = exports.ParticleShapeType.Box;
         /** The size of the box. */ _this.size = new engineMath.Vector3(1, 1, 1);
-        _this.shapeType = ParticleShapeType.Box;
         return _this;
     }
     var _proto = BoxShape.prototype;
@@ -30623,12 +30659,12 @@ __decorate([
     _inherits(CircleShape, BaseShape1);
     function CircleShape() {
         var _this;
-        _this = BaseShape1.call(this) || this;
+        _this = BaseShape1.apply(this, arguments) || this;
+        _this.shapeType = exports.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 = exports.ParticleShapeArcMode.Random;
         /** The speed of complete 360 degree rotation. */ _this.arcSpeed = 1.0;
-        _this.shapeType = ParticleShapeType.Circle;
         return _this;
     }
     var _proto = CircleShape.prototype;
@@ -30664,12 +30700,12 @@ __decorate([
     _inherits(ConeShape, BaseShape1);
     function ConeShape() {
         var _this;
-        _this = BaseShape1.call(this) || this;
+        _this = BaseShape1.apply(this, arguments) || this;
+        _this.shapeType = exports.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;
@@ -30729,9 +30765,9 @@ exports.ConeEmitType = void 0;
     _inherits(HemisphereShape, BaseShape1);
     function HemisphereShape() {
         var _this;
-        _this = BaseShape1.call(this) || this;
+        _this = BaseShape1.apply(this, arguments) || this;
+        _this.shapeType = exports.ParticleShapeType.Hemisphere;
         /** Radius of the shape to emit particles from. */ _this.radius = 1.0;
-        _this.shapeType = ParticleShapeType.Hemisphere;
         return _this;
     }
     var _proto = HemisphereShape.prototype;
@@ -30754,9 +30790,9 @@ exports.ConeEmitType = void 0;
     _inherits(SphereShape, BaseShape1);
     function SphereShape() {
         var _this;
-        _this = BaseShape1.call(this) || this;
+        _this = BaseShape1.apply(this, arguments) || this;
+        _this.shapeType = exports.ParticleShapeType.Sphere;
         /** Radius of the shape to emit particles from. */ _this.radius = 1.0;
-        _this.shapeType = ParticleShapeType.Sphere;
         return _this;
     }
     var _proto = SphereShape.prototype;