@galacean/engine-core 1.2.0-beta.5 → 1.2.0-beta.7

package/dist/main.js

@@ -3984,6 +3984,7 @@ var ShaderFactory = /*#__PURE__*/ function() {
         var program = this._glProgram;
         var uniformInfos = this._getUniformInfos();
         var attributeInfos = this._getAttributeInfos();
+        var basicResources = this._engine._basicResources;
         uniformInfos.forEach(function(param) {
             var name = param.name, size = param.size, type = param.type;
             var shaderUniform = new ShaderUniform(_this._engine);
@@ -4077,16 +4078,16 @@ var ShaderFactory = /*#__PURE__*/ function() {
                     var defaultTexture;
                     switch(type){
                         case gl.SAMPLER_2D:
-                            defaultTexture = _this._engine._magentaTexture2D;
+                            defaultTexture = basicResources.whiteTexture2D;
                             break;
                         case gl.SAMPLER_CUBE:
-                            defaultTexture = _this._engine._magentaTextureCube;
+                            defaultTexture = basicResources.whiteTextureCube;
                             break;
                         case gl.UNSIGNED_INT_SAMPLER_2D:
-                            defaultTexture = _this._engine._uintMagentaTexture2D;
+                            defaultTexture = basicResources.uintWhiteTexture2D;
                             break;
                         case gl.SAMPLER_2D_ARRAY:
-                            defaultTexture = _this._engine._magentaTexture2DArray;
+                            defaultTexture = basicResources.whiteTexture2DArray;
                             break;
                         case gl.SAMPLER_2D_SHADOW:
                             defaultTexture = _this._engine._depthTexture2D;
@@ -6416,14 +6417,15 @@ SlicedSpriteAssembler = __decorate([
         }
         this._endLoop(swapFn);
     };
-    _proto.forEachAndClean = function forEachAndClean(callbackFn) {
+    _proto.forEachAndClean = function forEachAndClean(callbackFn, swapFn) {
         this._startLoop();
+        var preEnd = this.length;
         var elements = this._elements;
-        for(var i = 0, n = this.length; i < n; i++){
+        for(var i = 0, n = preEnd; i < n; i++){
             var element = elements[i];
             element && callbackFn(element);
         }
-        this._endLoopAndClear();
+        this._endLoopAndClean(preEnd, elements, swapFn);
     };
     _proto.sort = function sort(compareFn) {
         Utils._quickSort(this._elements, 0, this.length, compareFn);
@@ -6456,9 +6458,17 @@ SlicedSpriteAssembler = __decorate([
             this._blankCount = 0;
         }
     };
-    _proto._endLoopAndClear = function _endLoopAndClear() {
+    _proto._endLoopAndClean = function _endLoopAndClean(preEnd, elements, swapFn) {
+        var index = 0;
+        for(var i = preEnd, n = this.length; i < n; i++){
+            var element = elements[i];
+            if (!element) continue;
+            elements[index] = element;
+            swapFn(element, index);
+            index++;
+        }
         this._isLooping = false;
-        this.length = 0;
+        this.length = index;
         this._blankCount = 0;
     };
     return DisorderedArray;
@@ -10970,6 +10980,38 @@ var PrimitiveType;
     PrimitiveMesh._spherePoleIdx = 0;
 })();
 
+function _is_native_reflect_construct() {
+    if (typeof Reflect === "undefined" || !Reflect.construct) return false;
+    if (Reflect.construct.sham) return false;
+    if (typeof Proxy === "function") return true;
+
+    try {
+        Boolean.prototype.valueOf.call(Reflect.construct(Boolean, [], function() {}));
+
+        return true;
+    } catch (e) {
+        return false;
+    }
+}
+
+function _construct(Parent, args, Class) {
+    if (_is_native_reflect_construct()) _construct = Reflect.construct;
+    else {
+        _construct = function construct(Parent, args, Class) {
+            var a = [null];
+            a.push.apply(a, args);
+            var Constructor = Function.bind.apply(Parent, a);
+            var instance = new Constructor();
+
+            if (Class) _set_prototype_of(instance, Class.prototype);
+
+            return instance;
+        };
+    }
+
+    return _construct.apply(null, arguments);
+}
+
 /**
  * Layer, used for bit operations.
  */ exports.Layer = void 0;
@@ -11057,10 +11099,14 @@ var ComponentCloner = /*#__PURE__*/ function() {
     /**
    * Add component based on the component type.
    * @param type - The type of the component
+   * @param args - The arguments of the component
    * @returns	The component which has been added
    */ _proto.addComponent = function addComponent(type) {
+        for(var _len = arguments.length, args = new Array(_len > 1 ? _len - 1 : 0), _key = 1; _key < _len; _key++){
+            args[_key - 1] = arguments[_key];
+        }
         ComponentsDependencies._addCheck(this, type);
-        var component = new type(this);
+        var component = _construct(type, [].concat(this, args));
         this._components.push(component);
         component._setActive(true, ActiveChangeFlag.All);
         return component;
@@ -11229,7 +11275,7 @@ var ComponentCloner = /*#__PURE__*/ function() {
    * Clone this entity include children and components.
    * @returns Cloned entity
    */ _proto.clone = function clone() {
-        var cloneEntity = this._createCloneEntity(this);
+        var cloneEntity = this._createCloneEntity();
         this._parseCloneEntity(this, cloneEntity, this, cloneEntity, new Map());
         return cloneEntity;
     };
@@ -11239,23 +11285,23 @@ var ComponentCloner = /*#__PURE__*/ function() {
         this._isTemplate = true;
         this._templateResource = templateResource;
     };
-    _proto._createCloneEntity = function _createCloneEntity(srcEntity) {
-        var cloneEntity = new Entity(srcEntity._engine, srcEntity.name);
+    _proto._createCloneEntity = function _createCloneEntity() {
+        var cloneEntity = new Entity(this._engine, this.name);
         var templateResource = this._templateResource;
         if (templateResource) {
             cloneEntity._templateResource = templateResource;
             templateResource._addReferCount(1);
         }
-        cloneEntity.layer = srcEntity.layer;
-        cloneEntity._isActive = srcEntity._isActive;
+        cloneEntity.layer = this.layer;
+        cloneEntity._isActive = this._isActive;
         var cloneTransform = cloneEntity.transform;
-        var srcTransform = srcEntity.transform;
+        var _this = this, srcTransform = _this.transform;
         cloneTransform.position = srcTransform.position;
         cloneTransform.rotation = srcTransform.rotation;
         cloneTransform.scale = srcTransform.scale;
-        var children = srcEntity._children;
-        for(var i = 0, n = srcEntity._children.length; i < n; i++){
-            cloneEntity.addChild(this._createCloneEntity(children[i]));
+        var srcChildren = this._children;
+        for(var i = 0, n = srcChildren.length; i < n; i++){
+            cloneEntity.addChild(srcChildren[i]._createCloneEntity());
         }
         return cloneEntity;
     };
@@ -13466,7 +13512,7 @@ var /**
         if (info) {
             return info;
         }
-        info = TextUtils._measureFontOrChar(fontString);
+        info = TextUtils._measureFontOrChar(fontString, TextUtils._measureString, false);
         fontSizeInfoCache[fontString] = info;
         return info;
     };
@@ -13487,7 +13533,7 @@ var /**
         return str;
     };
     TextUtils.measureChar = function measureChar(char, fontString) {
-        return TextUtils._measureFontOrChar(fontString, char);
+        return TextUtils._measureFontOrChar(fontString, char, true);
     };
     TextUtils.measureTextWithWrap = function measureTextWithWrap(renderer) {
         var subFont = renderer._subFont;
@@ -13707,15 +13753,15 @@ var /**
     /**
    * @internal
    * Use internal for CanvasRenderer plugin.
-   */ TextUtils._measureFontOrChar = function _measureFontOrChar(fontString, char) {
-        if (char === void 0) char = "";
+   */ TextUtils._measureFontOrChar = function _measureFontOrChar(fontString, measureString, isChar) {
         var _TextUtils_textContext = TextUtils.textContext(), canvas = _TextUtils_textContext.canvas, context = _TextUtils_textContext.context;
         context.font = fontString;
-        var measureString = char || TextUtils._measureString;
         // Safari gets data confusion through getImageData when the canvas width is not an integer.
         // The measure text width of some special invisible characters may be 0, so make sure the width is at least 1.
         // @todo: Text layout may vary from standard and not support emoji.
-        var width = Math.max(1, Math.round(context.measureText(measureString).width));
+        var textMetrics = context.measureText(measureString);
+        // In some case (ex: " "), actualBoundingBoxRight and actualBoundingBoxLeft will be 0, so use width.
+        var width = Math.max(1, Math.round(textMetrics.actualBoundingBoxRight - textMetrics.actualBoundingBoxLeft || textMetrics.width));
         var baseline = Math.ceil(context.measureText(TextUtils._measureBaseline).width);
         var height = baseline * TextUtils._heightMultiplier;
         baseline = TextUtils._baselineMultiplier * baseline | 0;
@@ -13760,12 +13806,7 @@ var /**
             descent = bottom - baseline + 1;
             size = ascent + descent;
         }
-        var sizeInfo = {
-            ascent: ascent,
-            descent: descent,
-            size: size
-        };
-        if (char) {
+        if (isChar) {
             var data = null;
             if (size > 0) {
                 var lineIntegerW = integerW * 4;
@@ -13773,7 +13814,7 @@ var /**
                 data = new Uint8Array(colorData.buffer, top * lineIntegerW, size * lineIntegerW);
             }
             return {
-                char: char,
+                char: measureString,
                 x: 0,
                 y: 0,
                 w: width,
@@ -13793,7 +13834,11 @@ var /**
                 data: data
             };
         } else {
-            return sizeInfo;
+            return {
+                ascent: ascent,
+                descent: descent,
+                size: size
+            };
         }
     };
     /**
@@ -15860,6 +15905,26 @@ var BaseMaterial = /*#__PURE__*/ function(Material1) {
         this.blitMesh = this._createBlitMesh(engine, vertices);
         this.flipYBlitMesh = this._createBlitMesh(engine, flipYVertices);
         this.blitMaterial = blitMaterial;
+        // Create white and magenta textures
+        var whitePixel = new Uint8Array([
+            255,
+            255,
+            255,
+            255
+        ]);
+        this.whiteTexture2D = this._create1x1Texture(engine, 0, exports.TextureFormat.R8G8B8A8, whitePixel);
+        this.whiteTextureCube = this._create1x1Texture(engine, 1, exports.TextureFormat.R8G8B8A8, whitePixel);
+        var isWebGL2 = engine._hardwareRenderer.isWebGL2;
+        if (isWebGL2) {
+            this.whiteTexture2DArray = this._create1x1Texture(engine, 2, exports.TextureFormat.R8G8B8A8, whitePixel);
+            var whitePixel32 = new Uint32Array([
+                255,
+                255,
+                255,
+                255
+            ]);
+            this.uintWhiteTexture2D = this._create1x1Texture(engine, 0, exports.TextureFormat.R32G32B32A32_UInt, whitePixel32);
+        }
     }
     var _proto = BasicResources.prototype;
     _proto._createBlitMesh = function _createBlitMesh(engine, vertices) {
@@ -15872,8 +15937,63 @@ var BaseMaterial = /*#__PURE__*/ function(Material1) {
         mesh.addSubMesh(0, 4, exports.MeshTopology.TriangleStrip);
         return mesh;
     };
+    _proto._create1x1Texture = function _create1x1Texture(engine, type, format, pixel) {
+        var texture;
+        switch(type){
+            case 0:
+                var texture2D = new Texture2D(engine, 1, 1, format, false);
+                texture2D.setPixelBuffer(pixel);
+                texture = texture2D;
+                break;
+            case 2:
+                var texture2DArray = new Texture2DArray(engine, 1, 1, 1, format, false);
+                texture2DArray.setPixelBuffer(0, pixel);
+                texture = texture2DArray;
+                break;
+            case 1:
+                var textureCube = new TextureCube(engine, 1, format, false);
+                for(var i = 0; i < 6; i++){
+                    textureCube.setPixelBuffer(exports.TextureCubeFace.PositiveX + i, pixel);
+                }
+                texture = textureCube;
+                break;
+            default:
+                throw "Invalid texture type";
+        }
+        texture.isGCIgnored = true;
+        engine.resourceManager.addContentRestorer(new /*#__PURE__*/ (function(ContentRestorer) {
+            _inherits(_class, ContentRestorer);
+            function _class() {
+                return ContentRestorer.call(this, texture);
+            }
+            var _proto = _class.prototype;
+            _proto.restoreContent = function restoreContent() {
+                switch(type){
+                    case 0:
+                        this.resource.setPixelBuffer(pixel);
+                        break;
+                    case 2:
+                        this.resource.setPixelBuffer(0, pixel);
+                        break;
+                    case 1:
+                        for(var i = 0; i < 6; i++){
+                            this.resource.setPixelBuffer(exports.TextureCubeFace.PositiveX + i, pixel);
+                        }
+                        break;
+                }
+            };
+            return _class;
+        }(ContentRestorer))());
+        return texture;
+    };
     return BasicResources;
 }();
+var TextureType;
+(function(TextureType) {
+    TextureType[TextureType["Texture2D"] = 0] = "Texture2D";
+    TextureType[TextureType["TextureCube"] = 1] = "TextureCube";
+    TextureType[TextureType["Texture2DArray"] = 2] = "Texture2DArray";
+})(TextureType || (TextureType = {}));
 
 /**
  * @internal
@@ -16667,17 +16787,35 @@ var /** @internal */ PromiseState;
     };
     /**
    * @internal
-   */ _proto._onSubAssetSuccess = function _onSubAssetSuccess(assetURL, value) {
-        var _this__subAssetPromiseCallbacks_assetURL;
-        (_this__subAssetPromiseCallbacks_assetURL = this._subAssetPromiseCallbacks[assetURL]) == null ? void 0 : _this__subAssetPromiseCallbacks_assetURL.resolve(value);
-        delete this._subAssetPromiseCallbacks[assetURL];
+   */ _proto._onSubAssetSuccess = function _onSubAssetSuccess(assetBaseURL, assetSubPath, value) {
+        var _this__subAssetPromiseCallbacks_assetBaseURL;
+        var subPromiseCallback = (_this__subAssetPromiseCallbacks_assetBaseURL = this._subAssetPromiseCallbacks[assetBaseURL]) == null ? void 0 : _this__subAssetPromiseCallbacks_assetBaseURL[assetSubPath];
+        if (subPromiseCallback) {
+            // Already resolved
+            subPromiseCallback.resolve(value);
+        } else {
+            var // Pending
+            _this__subAssetPromiseCallbacks, _assetBaseURL;
+            ((_this__subAssetPromiseCallbacks = this._subAssetPromiseCallbacks)[_assetBaseURL = assetBaseURL] || (_this__subAssetPromiseCallbacks[_assetBaseURL] = {}))[assetSubPath] = {
+                resolve: value
+            };
+        }
     };
     /**
    * @internal
-   */ _proto._onSubAssetFail = function _onSubAssetFail(assetURL, value) {
-        var _this__subAssetPromiseCallbacks_assetURL;
-        (_this__subAssetPromiseCallbacks_assetURL = this._subAssetPromiseCallbacks[assetURL]) == null ? void 0 : _this__subAssetPromiseCallbacks_assetURL.reject(value);
-        delete this._subAssetPromiseCallbacks[assetURL];
+   */ _proto._onSubAssetFail = function _onSubAssetFail(assetBaseURL, assetSubPath, value) {
+        var _this__subAssetPromiseCallbacks_assetBaseURL;
+        var subPromiseCallback = (_this__subAssetPromiseCallbacks_assetBaseURL = this._subAssetPromiseCallbacks[assetBaseURL]) == null ? void 0 : _this__subAssetPromiseCallbacks_assetBaseURL[assetSubPath];
+        if (subPromiseCallback) {
+            // Already rejected
+            subPromiseCallback.reject(value);
+        } else {
+            var // Pending
+            _this__subAssetPromiseCallbacks, _assetBaseURL;
+            ((_this__subAssetPromiseCallbacks = this._subAssetPromiseCallbacks)[_assetBaseURL = assetBaseURL] || (_this__subAssetPromiseCallbacks[_assetBaseURL] = {}))[assetSubPath] = {
+                reject: value
+            };
+        }
     };
     /**
    * @internal
@@ -16822,8 +16960,21 @@ var /** @internal */ PromiseState;
         if (!loader) {
             throw "loader not found: " + item.type;
         }
-        // Load asset
+        // Check sub asset
+        if (queryPath) {
+            // Check whether load main asset
+            var mainPromise = loadingPromises[assetBaseURL] || this._loadMainAsset(loader, item, assetBaseURL);
+            mainPromise.catch(function(e) {
+                _this._onSubAssetFail(assetBaseURL, queryPath, e);
+            });
+            return this._createSubAssetPromiseCallback(assetBaseURL, assetURL, queryPath);
+        }
+        return this._loadMainAsset(loader, item, assetBaseURL);
+    };
+    _proto._loadMainAsset = function _loadMainAsset(loader, item, assetBaseURL) {
+        var _this = this;
         item.url = assetBaseURL;
+        var loadingPromises = this._loadingPromises;
         var promise = loader.load(item, this);
         loadingPromises[assetBaseURL] = promise;
         promise.then(function(resource) {
@@ -16831,32 +16982,46 @@ var /** @internal */ PromiseState;
                 _this._addAsset(assetBaseURL, resource);
             }
             delete loadingPromises[assetBaseURL];
+            _this._releaseSubAssetPromiseCallback(assetBaseURL);
         }, function() {
-            return delete loadingPromises[assetBaseURL];
+            delete loadingPromises[assetBaseURL];
+            _this._releaseSubAssetPromiseCallback(assetBaseURL);
         });
-        if (queryPath) {
-            var subPromise = new AssetPromise(function(resolve, reject) {
-                _this._pushSubAssetPromiseCallback(assetURL, resolve, reject);
-            });
-            loadingPromises[assetURL] = subPromise;
-            subPromise.then(function() {
+        return promise;
+    };
+    _proto._createSubAssetPromiseCallback = function _createSubAssetPromiseCallback(assetBaseURL, assetURL, assetSubPath) {
+        var _this = this;
+        var _this__subAssetPromiseCallbacks_assetBaseURL, _subPromiseCallback, _subPromiseCallback1;
+        var loadingPromises = this._loadingPromises;
+        var subPromiseCallback = (_this__subAssetPromiseCallbacks_assetBaseURL = this._subAssetPromiseCallbacks[assetBaseURL]) == null ? void 0 : _this__subAssetPromiseCallbacks_assetBaseURL[assetSubPath];
+        var resolvedValue = (_subPromiseCallback = subPromiseCallback) == null ? void 0 : _subPromiseCallback.resolve;
+        var rejectedValue = (_subPromiseCallback1 = subPromiseCallback) == null ? void 0 : _subPromiseCallback1.reject;
+        var promise = new AssetPromise(function(resolve, reject) {
+            if (resolvedValue) {
+                // Already resolved
+                resolve(resolvedValue);
+            } else if (rejectedValue) {
+                // Already rejected
+                reject(rejectedValue);
+            } else {
+                var _this__subAssetPromiseCallbacks, _assetBaseURL;
+                // Pending
+                loadingPromises[assetURL] = promise;
+                ((_this__subAssetPromiseCallbacks = _this._subAssetPromiseCallbacks)[_assetBaseURL = assetBaseURL] || (_this__subAssetPromiseCallbacks[_assetBaseURL] = {}))[assetSubPath] = {
+                    resolve: resolve,
+                    reject: reject
+                };
+            }
+        });
+        if (!resolvedValue && !rejectedValue) {
+            promise.then(function() {
                 delete loadingPromises[assetURL];
             }, function() {
                 return delete loadingPromises[assetURL];
             });
-            promise.catch(function(e) {
-                _this._onSubAssetFail(assetURL, e);
-            });
-            return subPromise;
         }
         return promise;
     };
-    _proto._pushSubAssetPromiseCallback = function _pushSubAssetPromiseCallback(assetURL, resolve, reject) {
-        this._subAssetPromiseCallbacks[assetURL] = {
-            resolve: resolve,
-            reject: reject
-        };
-    };
     _proto._gc = function _gc(forceDestroy) {
         var objects = Utils.objectValues(this._referResourcePool);
         for(var i = 0, n = objects.length; i < n; i++){
@@ -16913,6 +17078,9 @@ var /** @internal */ PromiseState;
         });
         return result;
     };
+    _proto._releaseSubAssetPromiseCallback = function _releaseSubAssetPromiseCallback(assetBaseURL) {
+        delete this._subAssetPromiseCallbacks[assetBaseURL];
+    };
     /**
    * @internal
    * @beta Just for internal editor, not recommended for developers.
@@ -20406,7 +20574,6 @@ ShaderPool.init();
             _this.xrManager = new XRManager();
             _this.xrManager._initialize(_assert_this_initialized(_this), xrDevice);
         }
-        _this._initMagentaTextures(hardwareRenderer);
         if (!hardwareRenderer.canIUse(exports.GLCapabilityType.depthTexture)) {
             _this._macroCollection.enable(Engine._noDepthTextureMacro);
         } else {
@@ -20642,99 +20809,6 @@ ShaderPool.init();
     };
     /**
    * @internal
-   * Standalone for CanvasRenderer plugin.
-   */ _proto._initMagentaTextures = function _initMagentaTextures(hardwareRenderer) {
-        var whitePixel = new Uint8Array([
-            255,
-            255,
-            255,
-            255
-        ]);
-        var whiteTexture2D = new Texture2D(this, 1, 1, exports.TextureFormat.R8G8B8A8, false);
-        whiteTexture2D.setPixelBuffer(whitePixel);
-        whiteTexture2D.isGCIgnored = true;
-        var magentaPixel = new Uint8Array([
-            255,
-            0,
-            255,
-            255
-        ]);
-        var magentaTexture2D = new Texture2D(this, 1, 1, exports.TextureFormat.R8G8B8A8, false);
-        magentaTexture2D.setPixelBuffer(magentaPixel);
-        magentaTexture2D.isGCIgnored = true;
-        this.resourceManager.addContentRestorer(new /*#__PURE__*/ (function(ContentRestorer) {
-            _inherits(_class, ContentRestorer);
-            function _class() {
-                return ContentRestorer.call(this, magentaTexture2D);
-            }
-            var _proto = _class.prototype;
-            _proto.restoreContent = function restoreContent() {
-                this.resource.setPixelBuffer(magentaPixel);
-            };
-            return _class;
-        }(ContentRestorer))());
-        var magentaTextureCube = new TextureCube(this, 1, exports.TextureFormat.R8G8B8A8, false);
-        for(var i = 0; i < 6; i++){
-            magentaTextureCube.setPixelBuffer(exports.TextureCubeFace.PositiveX + i, magentaPixel);
-        }
-        magentaTextureCube.isGCIgnored = true;
-        this.resourceManager.addContentRestorer(new /*#__PURE__*/ (function(ContentRestorer) {
-            _inherits(_class, ContentRestorer);
-            function _class() {
-                return ContentRestorer.call(this, magentaTextureCube);
-            }
-            var _proto = _class.prototype;
-            _proto.restoreContent = function restoreContent() {
-                for(var i = 0; i < 6; i++){
-                    this.resource.setPixelBuffer(exports.TextureCubeFace.PositiveX + i, magentaPixel);
-                }
-            };
-            return _class;
-        }(ContentRestorer))());
-        this._whiteTexture2D = whiteTexture2D;
-        this._magentaTexture2D = magentaTexture2D;
-        this._magentaTextureCube = magentaTextureCube;
-        if (hardwareRenderer.isWebGL2) {
-            var magentaPixel32 = new Uint32Array([
-                255,
-                0,
-                255,
-                255
-            ]);
-            var uintMagentaTexture2D = new Texture2D(this, 1, 1, exports.TextureFormat.R32G32B32A32_UInt, false);
-            uintMagentaTexture2D.setPixelBuffer(magentaPixel32);
-            uintMagentaTexture2D.isGCIgnored = true;
-            this.resourceManager.addContentRestorer(new /*#__PURE__*/ (function(ContentRestorer) {
-                _inherits(_class, ContentRestorer);
-                function _class() {
-                    return ContentRestorer.call(this, uintMagentaTexture2D);
-                }
-                var _proto = _class.prototype;
-                _proto.restoreContent = function restoreContent() {
-                    this.resource.setPixelBuffer(magentaPixel32);
-                };
-                return _class;
-            }(ContentRestorer))());
-            var magentaTexture2DArray = new Texture2DArray(this, 1, 1, 1, exports.TextureFormat.R8G8B8A8, false);
-            magentaTexture2DArray.setPixelBuffer(0, magentaPixel);
-            magentaTexture2DArray.isGCIgnored = true;
-            this.resourceManager.addContentRestorer(new /*#__PURE__*/ (function(ContentRestorer) {
-                _inherits(_class, ContentRestorer);
-                function _class() {
-                    return ContentRestorer.call(this, magentaTexture2DArray);
-                }
-                var _proto = _class.prototype;
-                _proto.restoreContent = function restoreContent() {
-                    this.resource.setPixelBuffer(0, magentaPixel);
-                };
-                return _class;
-            }(ContentRestorer))());
-            this._uintMagentaTexture2D = uintMagentaTexture2D;
-            this._magentaTexture2DArray = magentaTexture2DArray;
-        }
-    };
-    /**
-   * @internal
    */ _proto._pendingGC = function _pendingGC() {
         if (this._frameInProcess) {
             this._waitingGC = true;
@@ -21374,6 +21448,8 @@ ShaderPool.init();
                 script._started = true;
                 _this.removeOnStartScript(script);
                 script.onStart();
+            }, function(element, index) {
+                element._onStartIndex = index;
             });
         }
     };
@@ -22964,6 +23040,14 @@ __decorate([
     DepthTextureMode[DepthTextureMode[/* Generate depth texture by pre-pass rendering. */ "PrePass"] = 1] = "PrePass";
 })(exports.DepthTextureMode || (exports.DepthTextureMode = {}));
 
+/**
+ * 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 = {}));
+
 /**
  * PipelinePass is a base class for all pipeline passes.
  */ var PipelinePass = function PipelinePass(engine) {
@@ -24314,7 +24398,7 @@ var /**
             depthOnlyPass.onConfig(camera);
             depthOnlyPass.onRender(context, cullingResults);
         } else {
-            camera.shaderData.setTexture(exports.Camera._cameraDepthTextureProperty, engine._whiteTexture2D);
+            camera.shaderData.setTexture(exports.Camera._cameraDepthTextureProperty, engine._basicResources.whiteTexture2D);
         }
         // Check if need to create internal color texture
         var independentCanvasEnabled = camera.independentCanvasEnabled;
@@ -24400,13 +24484,15 @@ var /**
             var replacementSubShaders = replacementShader.subShaders;
             var replacementTag = context.replacementTag;
             if (replacementTag) {
+                var materialSubShaderTagValue = materialSubShader.getTagValue(replacementTag);
                 for(var i = 0, n = replacementSubShaders.length; i < n; i++){
                     var subShader = replacementSubShaders[i];
-                    if (subShader.getTagValue(replacementTag) === materialSubShader.getTagValue(replacementTag)) {
+                    if (subShader.getTagValue(replacementTag) === materialSubShaderTagValue) {
                         this.pushRenderDataWithShader(context, data, subShader.passes, renderStates);
-                        break;
+                        return;
                     }
                 }
+                context.replacementFailureStrategy === exports.ReplacementFailureStrategy.KeepOriginalShader && this.pushRenderDataWithShader(context, data, materialSubShader.passes, renderStates);
             } else {
                 this.pushRenderDataWithShader(context, data, replacementSubShaders[0].passes, renderStates);
             }
@@ -24567,6 +24653,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);
@@ -24744,6 +24831,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);
@@ -24763,15 +24851,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