@galacean/engine-core 1.3.0-alpha.1 → 1.3.0-alpha.3

package/dist/main.js

@@ -2994,6 +2994,51 @@ exports.RenderStateDataKey = void 0;
     StencilOperation[StencilOperation[/** Decrements the current stencil buffer value. Wraps stencil buffer value to the maximum representable unsigned value when decrementing a stencil buffer value of 0. */ "DecrementWrap"] = 7] = "DecrementWrap";
 })(exports.StencilOperation || (exports.StencilOperation = {}));
 
+exports.ShaderPlatformTarget = void 0;
+(function(ShaderPlatformTarget) {
+    ShaderPlatformTarget[ShaderPlatformTarget["GLES100"] = 0] = "GLES100";
+    ShaderPlatformTarget[ShaderPlatformTarget["GLES300"] = 1] = "GLES300";
+})(exports.ShaderPlatformTarget || (exports.ShaderPlatformTarget = {}));
+
+function _array_like_to_array(arr, len) {
+    if (len == null || len > arr.length) len = arr.length;
+
+    for (var i = 0, arr2 = new Array(len); i < len; i++) arr2[i] = arr[i];
+
+    return arr2;
+}
+
+function _unsupported_iterable_to_array(o, minLen) {
+    if (!o) return;
+    if (typeof o === "string") return _array_like_to_array(o, minLen);
+
+    var n = Object.prototype.toString.call(o).slice(8, -1);
+
+    if (n === "Object" && o.constructor) n = o.constructor.name;
+    if (n === "Map" || n === "Set") return Array.from(n);
+    if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array(o, minLen);
+}
+
+function _create_for_of_iterator_helper_loose(o, allowArrayLike) {
+    var it = typeof Symbol !== "undefined" && o[Symbol.iterator] || o["@@iterator"];
+
+    if (it) return (it = it.call(o)).next.bind(it);
+    // Fallback for engines without symbol support
+    if (Array.isArray(o) || (it = _unsupported_iterable_to_array(o)) || allowArrayLike && o && typeof o.length === "number") {
+        if (it) o = it;
+
+        var i = 0;
+
+        return function() {
+            if (i >= o.length) return { done: true };
+
+            return { done: false, value: o[i++] };
+        };
+    }
+
+    throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
+}
+
 /**
  * Shader macro。
  */ var ShaderMacro = /*#__PURE__*/ function() {
@@ -3023,14 +3068,14 @@ exports.RenderStateDataKey = void 0;
                 maskMap.length++;
                 maskMap[index] = new Array(32);
             }
-            maskMap[index][bit] = key;
+            maskMap[index][bit] = macro;
             ShaderMacro._macroCounter++;
         }
         return macro;
     };
     /**
    * @internal
-   */ ShaderMacro._getNamesByMacros = function _getNamesByMacros(macros, out) {
+   */ ShaderMacro._getMacrosElements = function _getMacrosElements(macros, out) {
         var maskMap = ShaderMacro._macroMaskMap;
         var mask = macros._mask;
         out.length = 0;
@@ -3213,15 +3258,6 @@ exports.RenderStateDataKey = void 0;
     return ShaderMacroCollection;
 }();
 
-/**
- * Pipeline stage.
- */ exports.PipelineStage = void 0;
-(function(PipelineStage) {
-    PipelineStage[/** DepthOnly stage. */ "DepthOnly"] = "DepthOnly";
-    PipelineStage[/** Shadow caster stage. */ "ShadowCaster"] = "ShadowCaster";
-    PipelineStage[/** Forward shading stage. */ "Forward"] = "Forward";
-})(exports.PipelineStage || (exports.PipelineStage = {}));
-
 function _extends() {
     _extends = Object.assign || function assign(target) {
         for (var i = 1; i < arguments.length; i++) {
@@ -3235,9 +3271,18 @@ function _extends() {
     return _extends.apply(this, arguments);
 }
 
+/**
+ * Pipeline stage.
+ */ exports.PipelineStage = void 0;
+(function(PipelineStage) {
+    PipelineStage[/** DepthOnly stage. */ "DepthOnly"] = "DepthOnly";
+    PipelineStage[/** Shadow caster stage. */ "ShadowCaster"] = "ShadowCaster";
+    PipelineStage[/** Forward shading stage. */ "Forward"] = "Forward";
+})(exports.PipelineStage || (exports.PipelineStage = {}));
+
 var camera_declare = "#define GLSLIFY 1\nuniform vec3 camera_Position;uniform vec3 camera_Forward;uniform vec4 camera_ProjectionParams;"; // eslint-disable-line
 
-var common = "#define GLSLIFY 1\n#define PI 3.14159265359\n#define RECIPROCAL_PI 0.31830988618\n#define EPSILON 1e-6\n#define LOG2 1.442695\n#define saturate( a ) clamp( a, 0.0, 1.0 )\nfloat pow2(float x){return x*x;}vec4 RGBMToLinear(vec4 value,float maxRange){return vec4(value.rgb*value.a*maxRange,1.0);}vec4 gammaToLinear(vec4 srgbIn){return vec4(pow(srgbIn.rgb,vec3(2.2)),srgbIn.a);}vec4 linearToGamma(vec4 linearIn){return vec4(pow(linearIn.rgb,vec3(1.0/2.2)),linearIn.a);}uniform vec4 camera_DepthBufferParams;float remapDepthBufferLinear01(float z){return 1.0/(camera_DepthBufferParams.x*z+camera_DepthBufferParams.y);}\n#ifdef GRAPHICS_API_WEBGL2\n#define INVERSE_MAT(mat) inverse(mat)\n#else\nmat2 inverseMat(mat2 m){return mat2(m[1][1],-m[0][1],-m[1][0],m[0][0])/(m[0][0]*m[1][1]-m[0][1]*m[1][0]);}mat3 inverseMat(mat3 m){float a00=m[0][0],a01=m[0][1],a02=m[0][2];float a10=m[1][0],a11=m[1][1],a12=m[1][2];float a20=m[2][0],a21=m[2][1],a22=m[2][2];float b01=a22*a11-a12*a21;float b11=-a22*a10+a12*a20;float b21=a21*a10-a11*a20;float det=a00*b01+a01*b11+a02*b21;return mat3(b01,(-a22*a01+a02*a21),(a12*a01-a02*a11),b11,(a22*a00-a02*a20),(-a12*a00+a02*a10),b21,(-a21*a00+a01*a20),(a11*a00-a01*a10))/det;}mat4 inverseMat(mat4 m){float a00=m[0][0],a01=m[0][1],a02=m[0][2],a03=m[0][3],a10=m[1][0],a11=m[1][1],a12=m[1][2],a13=m[1][3],a20=m[2][0],a21=m[2][1],a22=m[2][2],a23=m[2][3],a30=m[3][0],a31=m[3][1],a32=m[3][2],a33=m[3][3],b00=a00*a11-a01*a10,b01=a00*a12-a02*a10,b02=a00*a13-a03*a10,b03=a01*a12-a02*a11,b04=a01*a13-a03*a11,b05=a02*a13-a03*a12,b06=a20*a31-a21*a30,b07=a20*a32-a22*a30,b08=a20*a33-a23*a30,b09=a21*a32-a22*a31,b10=a21*a33-a23*a31,b11=a22*a33-a23*a32,det=b00*b11-b01*b10+b02*b09+b03*b08-b04*b07+b05*b06;return mat4(a11*b11-a12*b10+a13*b09,a02*b10-a01*b11-a03*b09,a31*b05-a32*b04+a33*b03,a22*b04-a21*b05-a23*b03,a12*b08-a10*b11-a13*b07,a00*b11-a02*b08+a03*b07,a32*b02-a30*b05-a33*b01,a20*b05-a22*b02+a23*b01,a10*b10-a11*b08+a13*b06,a01*b08-a00*b10-a03*b06,a30*b04-a31*b02+a33*b00,a21*b02-a20*b04-a23*b00,a11*b07-a10*b09-a12*b06,a00*b09-a01*b07+a02*b06,a31*b01-a30*b03-a32*b00,a20*b03-a21*b01+a22*b00)/det;}\n#define INVERSE_MAT(mat) inverseMat(mat)\n#endif\n"; // eslint-disable-line
+var common = "#define GLSLIFY 1\n#define PI 3.14159265359\n#define RECIPROCAL_PI 0.31830988618\n#define EPSILON 1e-6\n#define LOG2 1.442695\n#define saturate( a ) clamp( a, 0.0, 1.0 )\nfloat pow2(float x){return x*x;}vec4 RGBMToLinear(vec4 value,float maxRange){return vec4(value.rgb*value.a*maxRange,1.0);}vec4 gammaToLinear(vec4 srgbIn){return vec4(pow(srgbIn.rgb,vec3(2.2)),srgbIn.a);}vec4 linearToGamma(vec4 linearIn){linearIn=max(linearIn,0.0);return vec4(pow(linearIn.rgb,vec3(1.0/2.2)),linearIn.a);}uniform vec4 camera_DepthBufferParams;float remapDepthBufferLinear01(float z){return 1.0/(camera_DepthBufferParams.x*z+camera_DepthBufferParams.y);}\n#ifdef GRAPHICS_API_WEBGL2\n#define INVERSE_MAT(mat) inverse(mat)\n#else\nmat2 inverseMat(mat2 m){return mat2(m[1][1],-m[0][1],-m[1][0],m[0][0])/(m[0][0]*m[1][1]-m[0][1]*m[1][0]);}mat3 inverseMat(mat3 m){float a00=m[0][0],a01=m[0][1],a02=m[0][2];float a10=m[1][0],a11=m[1][1],a12=m[1][2];float a20=m[2][0],a21=m[2][1],a22=m[2][2];float b01=a22*a11-a12*a21;float b11=-a22*a10+a12*a20;float b21=a21*a10-a11*a20;float det=a00*b01+a01*b11+a02*b21;return mat3(b01,(-a22*a01+a02*a21),(a12*a01-a02*a11),b11,(a22*a00-a02*a20),(-a12*a00+a02*a10),b21,(-a21*a00+a01*a20),(a11*a00-a01*a10))/det;}mat4 inverseMat(mat4 m){float a00=m[0][0],a01=m[0][1],a02=m[0][2],a03=m[0][3],a10=m[1][0],a11=m[1][1],a12=m[1][2],a13=m[1][3],a20=m[2][0],a21=m[2][1],a22=m[2][2],a23=m[2][3],a30=m[3][0],a31=m[3][1],a32=m[3][2],a33=m[3][3],b00=a00*a11-a01*a10,b01=a00*a12-a02*a10,b02=a00*a13-a03*a10,b03=a01*a12-a02*a11,b04=a01*a13-a03*a11,b05=a02*a13-a03*a12,b06=a20*a31-a21*a30,b07=a20*a32-a22*a30,b08=a20*a33-a23*a30,b09=a21*a32-a22*a31,b10=a21*a33-a23*a31,b11=a22*a33-a23*a32,det=b00*b11-b01*b10+b02*b09+b03*b08-b04*b07+b05*b06;return mat4(a11*b11-a12*b10+a13*b09,a02*b10-a01*b11-a03*b09,a31*b05-a32*b04+a33*b03,a22*b04-a21*b05-a23*b03,a12*b08-a10*b11-a13*b07,a00*b11-a02*b08+a03*b07,a32*b02-a30*b05-a33*b01,a20*b05-a22*b02+a23*b01,a10*b10-a11*b08+a13*b06,a01*b08-a00*b10-a03*b06,a30*b04-a31*b02+a33*b00,a21*b02-a20*b04-a23*b00,a11*b07-a10*b09-a12*b06,a00*b09-a01*b07+a02*b06,a31*b01-a30*b03-a32*b00,a20*b03-a21*b01+a22*b00)/det;}\n#define INVERSE_MAT(mat) inverseMat(mat)\n#endif\n"; // eslint-disable-line
 
 var common_vert = "#define GLSLIFY 1\nattribute vec3 POSITION;\n#ifdef RENDERER_HAS_UV\nattribute vec2 TEXCOORD_0;\n#endif\n#ifdef RENDERER_HAS_UV1\nattribute vec2 TEXCOORD_1;\n#endif\n#ifdef RENDERER_HAS_SKIN\nattribute vec4 JOINTS_0;attribute vec4 WEIGHTS_0;\n#ifdef RENDERER_USE_JOINT_TEXTURE\nuniform sampler2D renderer_JointSampler;uniform float renderer_JointCount;mat4 getJointMatrix(sampler2D smp,float index){float base=index/renderer_JointCount;float hf=0.5/renderer_JointCount;float v=base+hf;vec4 m0=texture2D(smp,vec2(0.125,v));vec4 m1=texture2D(smp,vec2(0.375,v));vec4 m2=texture2D(smp,vec2(0.625,v));vec4 m3=texture2D(smp,vec2(0.875,v));return mat4(m0,m1,m2,m3);}\n#else\nuniform mat4 renderer_JointMatrix[RENDERER_JOINTS_NUM];\n#endif\n#endif\n#ifdef RENDERER_ENABLE_VERTEXCOLOR\nattribute vec4 COLOR_0;\n#endif\n#include <transform_declare>\n#include <camera_declare>\nuniform vec4 material_TilingOffset;\n#ifndef MATERIAL_OMIT_NORMAL\n#ifdef RENDERER_HAS_NORMAL\nattribute vec3 NORMAL;\n#endif\n#ifdef RENDERER_HAS_TANGENT\nattribute vec4 TANGENT;\n#endif\n#endif\n"; // eslint-disable-line
 
@@ -3450,7 +3495,7 @@ var ShaderFactory = /*#__PURE__*/ function() {
     function ShaderFactory() {}
     ShaderFactory.parseCustomMacros = function parseCustomMacros(macros) {
         return macros.map(function(m) {
-            return "#define " + m + "\n";
+            return "#define " + (m.value ? m.name + " " + m.value : m.name) + "\n";
         }).join("");
     };
     ShaderFactory.registerInclude = function registerInclude(includeName, includeSource) {
@@ -4235,29 +4280,50 @@ var ShaderFactory = /*#__PURE__*/ function() {
     ShaderProgram._counter = 0;
 })();
 
+/**
+ * @internal
+ * Shader pass type
+ */ var ShaderType;
+(function(ShaderType) {
+    ShaderType[ShaderType[/** init by glsl */ "Canonical"] = 0] = "Canonical";
+    ShaderType[ShaderType[/** init by shader-lab */ "ShaderLab"] = 1] = "ShaderLab";
+})(ShaderType || (ShaderType = {}));
+
 /**
  * Shader pass containing vertex and fragment source.
  */ var ShaderPass = /*#__PURE__*/ function(ShaderPart1) {
     _inherits(ShaderPass, ShaderPart1);
-    function ShaderPass(nameOrVertexSource, vertexSourceOrFragmentSource, fragmentSourceOrTags, tags) {
+    function ShaderPass(nameOrVertexSource, vertexSourceOrFragmentSourceOrCode, fragmentSourceOrTagsOrVertexEntry, fragmentEntryOrTags, tags) {
         var _this;
         _this = ShaderPart1.call(this) || this;
         /** @internal */ _this._shaderPassId = 0;
         /** @internal */ _this._renderStateDataMap = {};
         /** @internal */ _this._shaderProgramPools = [];
+        /** @internal */ _this._path = "";
+        _this._platformMacros = [];
         _this._shaderPassId = ShaderPass._shaderPassCounter++;
-        if (typeof fragmentSourceOrTags === "string") {
+        _this._type = ShaderType.Canonical;
+        if (typeof fragmentEntryOrTags === "string") {
             _this._name = nameOrVertexSource;
-            _this._vertexSource = vertexSourceOrFragmentSource;
-            _this._fragmentSource = fragmentSourceOrTags;
-            tags = tags != null ? tags : {
+            _this._shaderLabSource = vertexSourceOrFragmentSourceOrCode;
+            _this._vertexEntry = fragmentSourceOrTagsOrVertexEntry;
+            _this._fragmentEntry = fragmentEntryOrTags;
+            tags = _extends({
+                pipelineStage: exports.PipelineStage.Forward
+            }, tags);
+            _this._type = ShaderType.ShaderLab;
+        } else if (typeof fragmentSourceOrTagsOrVertexEntry === "string") {
+            _this._name = nameOrVertexSource;
+            _this._vertexSource = vertexSourceOrFragmentSourceOrCode;
+            _this._fragmentSource = fragmentSourceOrTagsOrVertexEntry;
+            tags = fragmentEntryOrTags != null ? fragmentEntryOrTags : {
                 pipelineStage: exports.PipelineStage.Forward
             };
         } else {
             _this._name = "Default";
             _this._vertexSource = nameOrVertexSource;
-            _this._fragmentSource = vertexSourceOrFragmentSource;
-            tags = fragmentSourceOrTags != null ? fragmentSourceOrTags : {
+            _this._fragmentSource = vertexSourceOrFragmentSourceOrCode;
+            tags = fragmentSourceOrTagsOrVertexEntry != null ? fragmentSourceOrTagsOrVertexEntry : {
                 pipelineStage: exports.PipelineStage.Forward
             };
         }
@@ -4275,9 +4341,52 @@ var ShaderFactory = /*#__PURE__*/ function() {
         if (shaderProgram) {
             return shaderProgram;
         }
+        if (this._type === ShaderType.Canonical) {
+            shaderProgram = this._getCanonicalShaderProgram(engine, macroCollection);
+        } else {
+            shaderProgram = this._compileShaderProgram(engine, macroCollection, this._vertexEntry, this._fragmentEntry);
+        }
+        shaderProgramPool.cache(shaderProgram);
+        return shaderProgram;
+    };
+    /**
+   * @internal
+   */ _proto._destroy = function _destroy() {
+        var shaderProgramPools = this._shaderProgramPools;
+        for(var i = 0, n = shaderProgramPools.length; i < n; i++){
+            shaderProgramPools[i]._destroy();
+        }
+        shaderProgramPools.length = 0;
+    };
+    /**
+   * Shader Lab compilation
+   */ _proto._compileShaderProgram = function _compileShaderProgram(engine, macroCollection, vertexEntry, fragmentEntry) {
+        var _this = this, path = _this._path, platformMacros = _this._platformMacros;
         var isWebGL2 = engine._hardwareRenderer.isWebGL2;
-        var macroNameList = [];
-        ShaderMacro._getNamesByMacros(macroCollection, macroNameList);
+        var macros = new Array();
+        ShaderMacro._getMacrosElements(macroCollection, macros);
+        platformMacros.length = 0;
+        if (engine._hardwareRenderer.canIUse(exports.GLCapabilityType.shaderTextureLod)) {
+            platformMacros.push("HAS_TEX_LOD");
+        }
+        if (engine._hardwareRenderer.canIUse(exports.GLCapabilityType.standardDerivatives)) {
+            platformMacros.push("HAS_DERIVATIVES");
+        }
+        if (isWebGL2) {
+            platformMacros.push("GRAPHICS_API_WEBGL2");
+        } else {
+            platformMacros.push("GRAPHICS_API_WEBGL1");
+        }
+        var start = performance.now();
+        var _Shader__shaderLab__parseShaderPass = Shader._shaderLab._parseShaderPass(this._shaderLabSource, vertexEntry, fragmentEntry, macros, isWebGL2 ? exports.ShaderPlatformTarget.GLES300 : exports.ShaderPlatformTarget.GLES100, platformMacros, new URL(path, ShaderPass._shaderRootPath).href), vertex = _Shader__shaderLab__parseShaderPass.vertex, fragment = _Shader__shaderLab__parseShaderPass.fragment;
+        Logger.info("[ShaderLab compilation] cost time: " + (performance.now() - start) + "ms");
+        return new ShaderProgram(engine, vertex, fragment);
+    };
+    // TODO: remove it after migrate all shader to `ShaderLab`.
+    _proto._getCanonicalShaderProgram = function _getCanonicalShaderProgram(engine, macroCollection) {
+        var isWebGL2 = engine._hardwareRenderer.isWebGL2;
+        var macroNameList = new Array();
+        ShaderMacro._getMacrosElements(macroCollection, macroNameList);
         var macroNameStr = ShaderFactory.parseCustomMacros(macroNameList);
         var versionStr = isWebGL2 ? "#version 300 es" : "#version 100";
         var graphicAPI = isWebGL2 ? "#define GRAPHICS_API_WEBGL2" : "#define GRAPHICS_API_WEBGL1";
@@ -4294,24 +4403,17 @@ var ShaderFactory = /*#__PURE__*/ function() {
             vertexSource = ShaderFactory.convertTo300(vertexSource);
             fragmentSource = ShaderFactory.convertTo300(fragmentSource, true);
         }
-        shaderProgram = new ShaderProgram(engine, vertexSource, fragmentSource);
-        shaderProgramPool.cache(shaderProgram);
+        var shaderProgram = new ShaderProgram(engine, vertexSource, fragmentSource);
         return shaderProgram;
     };
-    /**
-   * @internal
-   */ _proto._destroy = function _destroy() {
-        var shaderProgramPools = this._shaderProgramPools;
-        for(var i = 0, n = shaderProgramPools.length; i < n; i++){
-            shaderProgramPools[i]._destroy();
-        }
-        shaderProgramPools.length = 0;
-    };
     return ShaderPass;
 }(ShaderPart);
 (function() {
     ShaderPass._shaderPassCounter = 0;
 })();
+(function() {
+    /** @internal */ ShaderPass._shaderRootPath = "shaders://root/";
+})();
 
 /**
  * Sub shader.
@@ -4948,6 +5050,18 @@ __decorate([
     }
     var _proto = Shader.prototype;
     /**
+   * @internal
+   * path should follow the specifications of [URL.origin](https://developer.mozilla.org/en-US/docs/Web/API/URL/origin), like: `shaders://root/`
+   */ _proto._registerPath = function _registerPath(path) {
+        for(var _iterator = _create_for_of_iterator_helper_loose(this._subShaders), _step; !(_step = _iterator()).done;){
+            var subShader = _step.value;
+            for(var _iterator1 = _create_for_of_iterator_helper_loose(subShader.passes), _step1; !(_step1 = _iterator1()).done;){
+                var shaderPass = _step1.value;
+                shaderPass._path = path;
+            }
+        }
+    };
+    /**
    * Compile shader variant by macro name list.
    *
    * @remarks
@@ -5010,45 +5124,44 @@ __decorate([
             if (!Shader._shaderLab) {
                 throw "ShaderLab has not been set up yet.";
             }
-            var shaderInfo = Shader._shaderLab.parseShader(nameOrShaderSource);
-            if (shaderMap[shaderInfo.name]) {
-                console.error('Shader named "' + shaderInfo.name + '" already exists.');
+            var shaderContent = Shader._shaderLab._parseShaderContent(nameOrShaderSource);
+            if (shaderMap[shaderContent.name]) {
+                console.error('Shader named "' + shaderContent.name + '" already exists.');
                 return;
             }
-            var subShaderList = shaderInfo.subShaders.map(function(subShaderInfo) {
-                var passList = subShaderInfo.passes.map(function(passInfo) {
-                    if (typeof passInfo === "string") {
+            var subShaderList = shaderContent.subShaders.map(function(subShaderContent) {
+                var passList = subShaderContent.passes.map(function(passInfo) {
+                    if (passInfo.isUsePass) {
                         var _Shader_find_subShaders_find, _Shader_find;
                         // Use pass reference
-                        var paths = passInfo.split("/");
+                        var paths = passInfo.name.split("/");
                         return (_Shader_find = Shader.find(paths[0])) == null ? void 0 : (_Shader_find_subShaders_find = _Shader_find.subShaders.find(function(subShader) {
                             return subShader.name === paths[1];
                         })) == null ? void 0 : _Shader_find_subShaders_find.passes.find(function(pass) {
                             return pass.name === paths[2];
                         });
                     }
-                    var shaderPass = new ShaderPass(passInfo.name, passInfo.vertexSource, passInfo.fragmentSource, passInfo.tags);
+                    var shaderPassContent = new ShaderPass(passInfo.name, passInfo.contents, passInfo.vertexEntry, passInfo.fragmentEntry, passInfo.tags);
                     var renderStates = passInfo.renderStates;
                     var renderState = new RenderState();
-                    shaderPass._renderState = renderState;
+                    shaderPassContent._renderState = renderState;
                     // Parse const render state
-                    var constRenderStateInfo = renderStates[0];
-                    for(var k in constRenderStateInfo){
-                        Shader._applyConstRenderStates(renderState, parseInt(k), constRenderStateInfo[k]);
+                    var constantMap = renderStates.constantMap, variableMap = renderStates.variableMap;
+                    for(var k in constantMap){
+                        Shader._applyConstRenderStates(renderState, parseInt(k), constantMap[k]);
                     }
                     // Parse variable render state
-                    var variableRenderStateInfo = renderStates[1];
                     var renderStateDataMap = {};
-                    for(var k1 in variableRenderStateInfo){
-                        renderStateDataMap[k1] = ShaderProperty.getByName(variableRenderStateInfo[k1]);
+                    for(var k1 in variableMap){
+                        renderStateDataMap[k1] = ShaderProperty.getByName(variableMap[k1]);
                     }
-                    shaderPass._renderStateDataMap = renderStateDataMap;
-                    return shaderPass;
+                    shaderPassContent._renderStateDataMap = renderStateDataMap;
+                    return shaderPassContent;
                 });
-                return new SubShader(shaderInfo.name, passList, subShaderInfo.tags);
+                return new SubShader(subShaderContent.name, passList, subShaderContent.tags);
             });
-            shader = new Shader(shaderInfo.name, subShaderList);
-            shaderMap[shaderInfo.name] = shader;
+            shader = new Shader(shaderContent.name, subShaderList);
+            shaderMap[shaderContent.name] = shader;
             return shader;
         } else {
             if (shaderMap[nameOrShaderSource]) {
@@ -8138,6 +8251,14 @@ var /**
     MSAASamples[MSAASamples[/** Multi-sample anti-aliasing with 8 samples. */ "EightX"] = 8] = "EightX";
 })(exports.MSAASamples || (exports.MSAASamples = {}));
 
+/**
+ * The strategy to use when a shader replacement fails.
+ */ exports.ReplacementFailureStrategy = void 0;
+(function(ReplacementFailureStrategy) {
+    ReplacementFailureStrategy[ReplacementFailureStrategy[/** Keep the original shader. */ "KeepOriginalShader"] = 0] = "KeepOriginalShader";
+    ReplacementFailureStrategy[ReplacementFailureStrategy[/** Do not render. */ "DoNotRender"] = 1] = "DoNotRender";
+})(exports.ReplacementFailureStrategy || (exports.ReplacementFailureStrategy = {}));
+
 var _Camera;
 var MathTemp = function MathTemp() {
 };
@@ -8187,6 +8308,7 @@ exports.Camera = (_Camera = /*#__PURE__*/ function(Component1) {
         /** @internal */ _this._virtualCamera = new VirtualCamera();
         /** @internal */ _this._replacementShader = null;
         /** @internal */ _this._replacementSubShaderTag = null;
+        /** @internal */ _this._replacementFailureStrategy = null;
         /** @internal */ _this._cameraIndex = -1;
         _this._priority = 0;
         _this._shaderData = new ShaderData(ShaderDataGroup.Camera);
@@ -8366,6 +8488,7 @@ exports.Camera = (_Camera = /*#__PURE__*/ function(Component1) {
         context.virtualCamera = virtualCamera;
         context.replacementShader = this._replacementShader;
         context.replacementTag = this._replacementSubShaderTag;
+        context.replacementFailureStrategy = this._replacementFailureStrategy;
         // compute cull frustum.
         if (this.enableFrustumCulling && this._frustumChangeFlag.flag) {
             this._frustum.calculateFromMatrix(virtualCamera.viewProjectionMatrix);
@@ -8385,15 +8508,18 @@ exports.Camera = (_Camera = /*#__PURE__*/ function(Component1) {
         this._renderPipeline.render(context, cubeFace, mipLevel, clearMask);
         this._engine._renderCount++;
     };
-    _proto.setReplacementShader = function setReplacementShader(shader, replacementTag) {
+    _proto.setReplacementShader = function setReplacementShader(shader, replacementTag, failureStrategy) {
+        if (failureStrategy === void 0) failureStrategy = exports.ReplacementFailureStrategy.KeepOriginalShader;
         this._replacementShader = shader;
         this._replacementSubShaderTag = typeof replacementTag === "string" ? ShaderTagKey.getByName(replacementTag) : replacementTag;
+        this._replacementFailureStrategy = failureStrategy;
     };
     /**
    * Reset and clear the replacement shader.
    */ _proto.resetReplacementShader = function resetReplacementShader() {
         this._replacementShader = null;
         this._replacementSubShaderTag = null;
+        this._replacementFailureStrategy = null;
     };
     /**
    * @inheritdoc
@@ -8507,7 +8633,7 @@ exports.Camera = (_Camera = /*#__PURE__*/ function(Component1) {
         this._checkMainCanvasAntialiasWaste();
     };
     _proto._checkMainCanvasAntialiasWaste = function _checkMainCanvasAntialiasWaste() {
-        if (this.independentCanvasEnabled && engineMath.Vector4.equals(this._viewport, PipelineUtils.defaultViewport)) {
+        if (this._phasedActiveInScene && this.independentCanvasEnabled && engineMath.Vector4.equals(this._viewport, PipelineUtils.defaultViewport)) {
             Logger.warn("Camera use independent canvas and viewport cover the whole screen, it is recommended to disable antialias, depth and stencil to save memory when create engine.");
         }
     };
@@ -10201,6 +10327,7 @@ var /**
                             break;
                         }
                     }
+                    context.replacementFailureStrategy === exports.ReplacementFailureStrategy.KeepOriginalShader && this.pushRenderElementByType(renderElement, subRenderElement, materialSubShader.passes, renderStates);
                 } else {
                     this.pushRenderElementByType(renderElement, subRenderElement, replacementSubShaders[0].passes, renderStates);
                 }
@@ -23345,7 +23472,7 @@ ShaderPool.init();
    */ _proto._initialize = function _initialize(configuration) {
         var _this = this;
         var shaderLab = configuration.shaderLab, physics = configuration.physics;
-        if (shaderLab) {
+        if (shaderLab && !Shader._shaderLab) {
             Shader._shaderLab = shaderLab;
         }
         var initializePromises = new Array();
@@ -24352,9 +24479,9 @@ ShaderPool.init();
         /** Shadow bias.*/ _this.shadowBias = 1;
         /** Shadow mapping normal-based bias. */ _this.shadowNormalBias = 1;
         /** Near plane value to use for shadow frustums. */ _this.shadowNearPlane = 0.1;
-        /** Shadow intensity, the larger the value, the clearer and darker the shadow. */ _this.shadowStrength = 1.0;
         /** @internal */ _this._lightIndex = -1;
         /** @internal */ _this._lightColor = new engineMath.Color();
+        _this._shadowStrength = 1.0;
         _this._color = new engineMath.Color(1, 1, 1, 1);
         return _this;
     }
@@ -24370,6 +24497,15 @@ ShaderPool.init();
         return this._lightColor;
     };
     _create_class(Light, [
+        {
+            key: "shadowStrength",
+            get: /** Shadow intensity, the larger the value, the clearer and darker the shadow, range [0,1]. */ function get() {
+                return this._shadowStrength;
+            },
+            set: function set(value) {
+                this._shadowStrength = engineMath.MathUtil.clamp(value, 0, 1);
+            }
+        },
         {
             key: "color",
             get: /**
@@ -25085,7 +25221,7 @@ var BloomEffect = /*#__PURE__*/ function() {
                 return this._scatter;
             },
             set: function set(value) {
-                value = Math.min(Math.max(0, value), 1);
+                value = engineMath.MathUtil.clamp(value, 0, 1);
                 if (value !== this._scatter) {
                     this._scatter = value;
                     var params = this._bloomMaterial.shaderData.getVector4(BloomEffect._bloomParams);
@@ -25284,6 +25420,9 @@ var TonemappingEffect = /*#__PURE__*/ function() {
  */ var _PostProcessManager = /*#__PURE__*/ function() {
     function _PostProcessManager(scene) {
         this.scene = scene;
+        this./**
+   * Whether the post process manager is active.
+   */ isActive = true;
         var uberShader = Shader.find(_PostProcessManager.UBER_SHADER_NAME);
         var uberMaterial = new Material(scene.engine, uberShader);
         var depthState = uberMaterial.renderState.depthState;
@@ -25317,7 +25456,7 @@ var TonemappingEffect = /*#__PURE__*/ function() {
             get: /**
    * Whether has active post process effect.
    */ function get() {
-                return this._bloomEffect.enabled || this._tonemappingEffect.enabled;
+                return this.isActive && (this._bloomEffect.enabled || this._tonemappingEffect.enabled);
             }
         }
     ]);