@galacean/engine-core 1.0.0-beta.1 → 1.0.0-beta.10

package/dist/main.js

@@ -682,7 +682,9 @@ __decorate([
    */ _proto._addToResourceManager = function _addToResourceManager(path) {
         this._engine.resourceManager._addAsset(path, this);
     };
-    _proto._onDestroy = function _onDestroy() {
+    /**
+   * @internal
+   */ _proto._onDestroy = function _onDestroy() {
         EngineObject.prototype._onDestroy.call(this);
         this._engine.resourceManager._deleteReferResource(this);
         var refCount = this._getReferCount();
@@ -814,7 +816,9 @@ var GraphicsResource = /*#__PURE__*/ function(ReferResource) {
         return _this;
     }
     var _proto = GraphicsResource.prototype;
-    _proto._onDestroy = function _onDestroy() {
+    /**
+   * @internal
+   */ _proto._onDestroy = function _onDestroy() {
         ReferResource.prototype._onDestroy.call(this);
         this.engine.resourceManager._deleteGraphicResource(this);
     };
@@ -893,7 +897,9 @@ var Logger = {
         platformTexture.depthCompareFunction = this._depthCompareFunction;
         platformTexture.setUseDepthCompareMode(this._useDepthCompareMode);
     };
-    _proto._onDestroy = function _onDestroy() {
+    /**
+   * @internal
+   */ _proto._onDestroy = function _onDestroy() {
         GraphicsResource.prototype._onDestroy.call(this);
         this._platformTexture.destroy();
         this._platformTexture = null;
@@ -1043,9 +1049,11 @@ var Logger = {
                 renderTexture
             ];
             for(var i = 0, n = colorTextures.length; i < n; i++){
-                if (colorTextures[i]._isDepthTexture) {
+                var colorTexture = colorTextures[i];
+                if (colorTexture._isDepthTexture) {
                     throw "Render texture can't use depth format.";
                 }
+                colorTexture._addReferCount(1);
             }
             _this._colorTextures = colorTextures;
         } else {
@@ -1056,6 +1064,7 @@ var Logger = {
                 throw "Depth texture must use depth format.";
             }
             _this._depthTexture = depth;
+            _this._depthTexture._addReferCount(1);
         }
         _this._platformRenderTarget = engine._hardwareRenderer.createPlatformRenderTarget(_assert_this_initialized(_this));
         return _this;
@@ -1081,10 +1090,18 @@ var Logger = {
             this._depthTexture && this._depthTexture.generateMipmaps();
         }
     };
-    _proto._onDestroy = function _onDestroy() {
+    /**
+   * @internal
+   */ _proto._onDestroy = function _onDestroy() {
+        var _this__depthTexture;
         GraphicsResource.prototype._onDestroy.call(this);
         this._platformRenderTarget.destroy();
-        this._colorTextures.length = 0;
+        var _this = this, colorTextures = _this._colorTextures;
+        for(var i = 0, n = colorTextures.length; i < n; i++){
+            colorTextures[i]._addReferCount(-1);
+        }
+        colorTextures.length = 0;
+        (_this__depthTexture = this._depthTexture) == null ? void 0 : _this__depthTexture._addReferCount(-1);
         this._depthTexture = null;
         this._depth = null;
     };
@@ -1459,7 +1476,9 @@ var Logger = {
     _proto.getCharInfo = function getCharInfo(char) {
         return this._charInfoMap[char.charCodeAt(0)];
     };
-    _proto._onDestroy = function _onDestroy() {
+    /**
+   * @internal
+   */ _proto._onDestroy = function _onDestroy() {
         ReferResource.prototype._onDestroy.call(this);
         this.texture.destroy();
         this.texture = null;
@@ -1966,6 +1985,7 @@ var Logger = {
         var fontAtlas = new FontAtlas(engine);
         var texture = new Texture2D(engine, 256, 256);
         fontAtlas.texture = texture;
+        fontAtlas.isGCIgnored = texture.isGCIgnored = true;
         this._fontAtlases.push(fontAtlas);
         var nativeFontString = this.nativeFontString;
         engine.resourceManager.addContentRestorer(new /*#__PURE__*/ (function(ContentRestorer) {
@@ -2022,7 +2042,9 @@ var Logger = {
         subFontMap[key] = subFont;
         return subFont;
     };
-    _proto._onDestroy = function _onDestroy() {
+    /**
+   * @internal
+   */ _proto._onDestroy = function _onDestroy() {
         ReferResource.prototype._onDestroy.call(this);
         var subFontMap = this._subFontMap;
         for(var k in subFontMap){
@@ -3241,7 +3263,9 @@ exports.GLCapabilityType = void 0;
             }
         }
     };
-    _proto._onDestroy = function _onDestroy() {
+    /**
+   * @internal
+   */ _proto._onDestroy = function _onDestroy() {
         EngineObject.prototype._onDestroy.call(this);
         this._entity._removeComponent(this);
         if (this._entity.isActiveInHierarchy) {
@@ -5251,14 +5275,14 @@ SystemInfo._initialize();
     Keys[Keys[/** Tab or ⇥. */ "Tab"] = 63] = "Tab";
     Keys[Keys[/** Japanese: 変換 (henkan). */ "Convert"] = 64] = "Convert";
     Keys[Keys[/** Japanese: カタカナ/ひらがな/ローマ字 (katakana/hiragana/romaji). */ "KanaMode"] = 65] = "KanaMode";
-    Keys[Keys[/** 
-     * Korean: HangulMode 한/영 (han/yeong).
-     * Japanese (Mac keyboard): かな (kana).
-     * */ "Lang1"] = 66] = "Lang1";
     Keys[Keys[/**
-     * 	Korean: Hanja 한자 (hanja).
-     *  Japanese (Mac keyboard): 英数 (eisu).
-     */ "Lang2"] = 67] = "Lang2";
+   * Korean: HangulMode 한/영 (han/yeong).
+   * Japanese (Mac keyboard): かな (kana).
+   * */ "Lang1"] = 66] = "Lang1";
+    Keys[Keys[/**
+   * 	Korean: Hanja 한자 (hanja).
+   *  Japanese (Mac keyboard): 英数 (eisu).
+   */ "Lang2"] = 67] = "Lang2";
     Keys[Keys[/** Japanese (word-processing keyboard): Katakana. */ "Lang3"] = 68] = "Lang3";
     Keys[Keys[/** Japanese (word-processing keyboard): Hiragana. */ "Lang4"] = 69] = "Lang4";
     Keys[Keys[/** Japanese (word-processing keyboard): Zenkaku/Hankaku. */ "Lang5"] = 70] = "Lang5";
@@ -5275,46 +5299,46 @@ SystemInfo._initialize();
     Keys[Keys[/** → */ "ArrowRight"] = 81] = "ArrowRight";
     Keys[Keys[/** ↑ */ "ArrowUp"] = 82] = "ArrowUp";
     Keys[Keys[/** On the Mac, the "NumLock" code should be used for the numpad Clear key. */ "NumLock"] = 83] = "NumLock";
-    Keys[Keys[/** 
-     * 0 Ins on a keyboard.
-     * 0 on a phone or remote control.
-     * */ "Numpad0"] = 84] = "Numpad0";
     Keys[Keys[/**
-     * 1 End on a keyboard.
-     * 1 or 1 QZ on a phone or remote control.
-     */ "Numpad1"] = 85] = "Numpad1";
+   * 0 Ins on a keyboard.
+   * 0 on a phone or remote control.
+   * */ "Numpad0"] = 84] = "Numpad0";
     Keys[Keys[/**
-     * 2 ↓ on a keyboard.
-     * 2 ABC on a phone or remote control.
-     */ "Numpad2"] = 86] = "Numpad2";
+   * 1 End on a keyboard.
+   * 1 or 1 QZ on a phone or remote control.
+   */ "Numpad1"] = 85] = "Numpad1";
     Keys[Keys[/**
-     * 3 PgDn on a keyboard.
-     * 3 DEF on a phone or remote control.
-     */ "Numpad3"] = 87] = "Numpad3";
+   * 2 ↓ on a keyboard.
+   * 2 ABC on a phone or remote control.
+   */ "Numpad2"] = 86] = "Numpad2";
     Keys[Keys[/**
-     * 4 ← on a keyboard.
-     * 4 GHI on a phone or remote control.
-     */ "Numpad4"] = 88] = "Numpad4";
+   * 3 PgDn on a keyboard.
+   * 3 DEF on a phone or remote control.
+   */ "Numpad3"] = 87] = "Numpad3";
     Keys[Keys[/**
-     * 5 on a keyboard.
-     * 5 JKL on a phone or remote control.
-     */ "Numpad5"] = 89] = "Numpad5";
+   * 4 ← on a keyboard.
+   * 4 GHI on a phone or remote control.
+   */ "Numpad4"] = 88] = "Numpad4";
     Keys[Keys[/**
-     * 6 → on a keyboard.
-     * 6 MNO on a phone or remote control.
-     */ "Numpad6"] = 90] = "Numpad6";
+   * 5 on a keyboard.
+   * 5 JKL on a phone or remote control.
+   */ "Numpad5"] = 89] = "Numpad5";
     Keys[Keys[/**
-     * 7 Home on a keyboard.
-     * 7 PQRS or 7 PRS on a phone or remote control.
-     */ "Numpad7"] = 91] = "Numpad7";
+   * 6 → on a keyboard.
+   * 6 MNO on a phone or remote control.
+   */ "Numpad6"] = 90] = "Numpad6";
     Keys[Keys[/**
-     * 8 ↑ on a keyboard.
-     * 8 TUV on a phone or remote control.
-     */ "Numpad8"] = 92] = "Numpad8";
+   * 7 Home on a keyboard.
+   * 7 PQRS or 7 PRS on a phone or remote control.
+   */ "Numpad7"] = 91] = "Numpad7";
     Keys[Keys[/**
-     * 9 PgUp on a keyboard.
-     * 9 WXYZ or 9 WXY on a phone or remote control.
-     */ "Numpad9"] = 93] = "Numpad9";
+   * 8 ↑ on a keyboard.
+   * 8 TUV on a phone or remote control.
+   */ "Numpad8"] = 92] = "Numpad8";
+    Keys[Keys[/**
+   * 9 PgUp on a keyboard.
+   * 9 WXYZ or 9 WXY on a phone or remote control.
+   */ "Numpad9"] = 93] = "Numpad9";
     Keys[Keys[/** + */ "NumpadAdd"] = 94] = "NumpadAdd";
     Keys[Keys[/** Found on the Microsoft Natural Keyboard. */ "NumpadBackspace"] = 95] = "NumpadBackspace";
     Keys[Keys[/** C or AC (All Clear). Also for use with numpads that have a Clear key that is separate from the NumLock key. On the Mac, the numpad Clear key should always be encoded as "NumLock". */ "NumpadClear"] = 96] = "NumpadClear";
@@ -5330,16 +5354,16 @@ SystemInfo._initialize();
     Keys[Keys[/** MR Replace the current entry with the value stored in memory. */ "NumpadMemoryRecall"] = 106] = "NumpadMemoryRecall";
     Keys[Keys[/** MS Replace the value stored in memory with the current entry. */ "NumpadMemoryStore"] = 107] = "NumpadMemoryStore";
     Keys[Keys[/** M- Subtract current entry from the value stored in memory. */ "NumpadMemorySubtract"] = 108] = "NumpadMemorySubtract";
-    Keys[Keys[/** 
-     * * on a keyboard. For use with numpads that provide mathematical operations (+, -, * and /).
-     * Use "NumpadStar" for the * key on phones and remote controls.
-     */ "NumpadMultiply"] = 109] = "NumpadMultiply";
+    Keys[Keys[/**
+   * * on a keyboard. For use with numpads that provide mathematical operations (+, -, * and /).
+   * Use "NumpadStar" for the * key on phones and remote controls.
+   */ "NumpadMultiply"] = 109] = "NumpadMultiply";
     Keys[Keys[/** ( Found on the Microsoft Natural Keyboard. */ "NumpadParenLeft"] = 110] = "NumpadParenLeft";
     Keys[Keys[/** ) Found on the Microsoft Natural Keyboard. */ "NumpadParenRight"] = 111] = "NumpadParenRight";
     Keys[Keys[/**
-     * * on a phone or remote control device. This key is typically found below the 7 key and to the left of the 0 key.
-     * Use "NumpadMultiply" for the * key on numeric keypads.
-     */ "NumpadStar"] = 112] = "NumpadStar";
+   * * on a phone or remote control device. This key is typically found below the 7 key and to the left of the 0 key.
+   * Use "NumpadMultiply" for the * key on numeric keypads.
+   */ "NumpadStar"] = 112] = "NumpadStar";
     Keys[Keys[/** - */ "NumpadSubtract"] = 113] = "NumpadSubtract";
     Keys[Keys[/** Esc or ⎋. */ "Escape"] = 114] = "Escape";
     Keys[Keys[/** F1 */ "F1"] = 115] = "F1";
@@ -6014,7 +6038,9 @@ exports.Collider = /*#__PURE__*/ function(Component) {
    */ _proto._onDisable = function _onDisable() {
         this.engine.physicsManager._removeCollider(this);
     };
-    _proto._onDestroy = function _onDestroy() {
+    /**
+   * @internal
+   */ _proto._onDestroy = function _onDestroy() {
         Component.prototype._onDestroy.call(this);
         this.clearShapes();
         this._nativeCollider.destroy();
@@ -7864,7 +7890,10 @@ exports.DynamicColliderConstraints = void 0;
         return _this;
     }
     var _proto = Light.prototype;
-    _proto._getLightColor = function _getLightColor() {
+    /**
+   * Light Color, include intensity.
+   * @internal
+   */ _proto._getLightIntensityColor = function _getLightIntensityColor() {
         this._lightColor.r = this.color.r * this.intensity;
         this._lightColor.g = this.color.g * this.intensity;
         this._lightColor.b = this.color.b * this.intensity;
@@ -7934,15 +7963,21 @@ __decorate([
         var cullingMaskStart = lightIndex * 2;
         var colorStart = lightIndex * 3;
         var directionStart = lightIndex * 3;
-        var lightColor = this._getLightColor();
+        var lightColor = this._getLightIntensityColor();
         var direction = this.direction;
         var data = DirectLight._combinedData;
         var cullingMask = this.cullingMask;
         data.cullingMask[cullingMaskStart] = cullingMask & 65535;
         data.cullingMask[cullingMaskStart + 1] = cullingMask >>> 16 & 65535;
-        data.color[colorStart] = lightColor.r;
-        data.color[colorStart + 1] = lightColor.g;
-        data.color[colorStart + 2] = lightColor.b;
+        if (this.engine.settings.colorSpace === exports.ColorSpace.Linear) {
+            data.color[colorStart] = engineMath.Color.gammaToLinearSpace(lightColor.r);
+            data.color[colorStart + 1] = engineMath.Color.gammaToLinearSpace(lightColor.g);
+            data.color[colorStart + 2] = engineMath.Color.gammaToLinearSpace(lightColor.b);
+        } else {
+            data.color[colorStart] = lightColor.r;
+            data.color[colorStart + 1] = lightColor.g;
+            data.color[colorStart + 2] = lightColor.b;
+        }
         data.direction[directionStart] = direction.x;
         data.direction[directionStart + 1] = direction.y;
         data.direction[directionStart + 2] = direction.z;
@@ -8031,15 +8066,21 @@ __decorate([
         var colorStart = lightIndex * 3;
         var positionStart = lightIndex * 3;
         var distanceStart = lightIndex;
-        var lightColor = this._getLightColor();
+        var lightColor = this._getLightIntensityColor();
         var lightPosition = this.position;
         var data = PointLight._combinedData;
         var cullingMask = this.cullingMask;
         data.cullingMask[cullingMaskStart] = cullingMask & 65535;
         data.cullingMask[cullingMaskStart + 1] = cullingMask >>> 16 & 65535;
-        data.color[colorStart] = lightColor.r;
-        data.color[colorStart + 1] = lightColor.g;
-        data.color[colorStart + 2] = lightColor.b;
+        if (this.engine.settings.colorSpace === exports.ColorSpace.Linear) {
+            data.color[colorStart] = engineMath.Color.gammaToLinearSpace(lightColor.r);
+            data.color[colorStart + 1] = engineMath.Color.gammaToLinearSpace(lightColor.g);
+            data.color[colorStart + 2] = engineMath.Color.gammaToLinearSpace(lightColor.b);
+        } else {
+            data.color[colorStart] = lightColor.r;
+            data.color[colorStart + 1] = lightColor.g;
+            data.color[colorStart + 2] = lightColor.b;
+        }
         data.position[positionStart] = lightPosition.x;
         data.position[positionStart + 1] = lightPosition.y;
         data.position[positionStart + 2] = lightPosition.z;
@@ -8132,16 +8173,22 @@ __decorate([
         var distanceStart = lightIndex;
         var penumbraCosStart = lightIndex;
         var angleCosStart = lightIndex;
-        var color = this._getLightColor();
+        var lightColor = this._getLightIntensityColor();
         var position = this.position;
         var direction = this.direction;
         var data = SpotLight._combinedData;
         var cullingMask = this.cullingMask;
         data.cullingMask[cullingMaskStart] = cullingMask & 65535;
         data.cullingMask[cullingMaskStart + 1] = cullingMask >>> 16 & 65535;
-        data.color[colorStart] = color.r;
-        data.color[colorStart + 1] = color.g;
-        data.color[colorStart + 2] = color.b;
+        if (this.engine.settings.colorSpace === exports.ColorSpace.Linear) {
+            data.color[colorStart] = engineMath.Color.gammaToLinearSpace(lightColor.r);
+            data.color[colorStart + 1] = engineMath.Color.gammaToLinearSpace(lightColor.g);
+            data.color[colorStart + 2] = engineMath.Color.gammaToLinearSpace(lightColor.b);
+        } else {
+            data.color[colorStart] = lightColor.r;
+            data.color[colorStart + 1] = lightColor.g;
+            data.color[colorStart + 2] = lightColor.b;
+        }
         data.position[positionStart] = position.x;
         data.position[positionStart + 1] = position.y;
         data.position[positionStart + 2] = position.z;
@@ -8784,6 +8831,7 @@ __decorate([
     _proto.cloneTo = function cloneTo(target) {
         CloneManager.deepCloneObject(this._macroCollection, target._macroCollection);
         Object.assign(target._macroMap, this._macroMap);
+        var referCount = target._getReferCount();
         var propertyValueMap = this._propertyValueMap;
         var targetPropertyValueMap = target._propertyValueMap;
         var keys = Object.keys(propertyValueMap);
@@ -8795,6 +8843,7 @@ __decorate([
                     targetPropertyValueMap[k] = property;
                 } else if (_instanceof(property, Texture)) {
                     targetPropertyValueMap[k] = property;
+                    referCount > 0 && property._addReferCount(referCount);
                 } else if (_instanceof(property, Array) || _instanceof(property, Float32Array) || _instanceof(property, Int32Array)) {
                     targetPropertyValueMap[k] = property.slice();
                 } else {
@@ -9499,11 +9548,11 @@ var camera_declare = "#define GLSLIFY 1\nuniform vec3 camera_Position;"; // esli
 
 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);}\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_HAS_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
+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
 
 var transform_declare = "#define GLSLIFY 1\nuniform mat4 renderer_LocalMat;uniform mat4 renderer_ModelMat;uniform mat4 camera_ViewMat;uniform mat4 camera_ProjMat;uniform mat4 renderer_MVMat;uniform mat4 renderer_MVPMat;uniform mat4 renderer_NormalMat;"; // eslint-disable-line
 
-var color_share = "#define GLSLIFY 1\n#ifdef RENDERER_HAS_VERTEXCOLOR\nvarying vec4 v_color;\n#endif\n"; // eslint-disable-line
+var color_share = "#define GLSLIFY 1\n#ifdef RENDERER_ENABLE_VERTEXCOLOR\nvarying vec4 v_color;\n#endif\n"; // eslint-disable-line
 
 var FogFragmentDeclaration = "#define GLSLIFY 1\n#if SCENE_FOG_MODE != 0\nvarying vec3 v_positionVS;uniform vec4 scene_FogColor;uniform vec4 scene_FogParams;float ComputeFogIntensity(float fogDepth){\n#if SCENE_FOG_MODE == 1\nreturn clamp(fogDepth*scene_FogParams.x+scene_FogParams.y,0.0,1.0);\n#elif SCENE_FOG_MODE == 2\nreturn clamp(exp2(-fogDepth*scene_FogParams.z),0.0,1.0);\n#elif SCENE_FOG_MODE == 3\nfloat factor=fogDepth*scene_FogParams.w;return clamp(exp2(-factor*factor),0.0,1.0);\n#endif\n}\n#endif\n"; // eslint-disable-line
 
@@ -9523,7 +9572,7 @@ var blendShape_input = "#define GLSLIFY 1\n#ifdef RENDERER_HAS_BLENDSHAPE\n#ifde
 
 var blendShape_vert = "#define GLSLIFY 1\n#ifdef RENDERER_HAS_BLENDSHAPE\n#ifdef RENDERER_BLENDSHAPE_USE_TEXTURE\nint vertexOffset=gl_VertexID*renderer_BlendShapeTextureInfo.x;for(int i=0;i<RENDERER_BLENDSHAPE_COUNT;i++){int vertexElementOffset=vertexOffset;float weight=renderer_BlendShapeWeights[i];position.xyz+=getBlendShapeVertexElement(i,vertexElementOffset)*weight;\n#ifndef MATERIAL_OMIT_NORMAL\n#if defined( RENDERER_HAS_NORMAL ) && defined( RENDERER_BLENDSHAPE_HAS_NORMAL )\nvertexElementOffset+=1;normal+=getBlendShapeVertexElement(i,vertexElementOffset)*weight;\n#endif\n#if defined( RENDERER_HAS_TANGENT ) && defined(RENDERER_BLENDSHAPE_HAS_TANGENT) && ( defined(MATERIAL_HAS_NORMALTEXTURE) || defined(MATERIAL_HAS_CLEAR_COAT_NORMAL_TEXTURE) )\nvertexElementOffset+=1;tangent.xyz+=getBlendShapeVertexElement(i,vertexElementOffset)*weight;\n#endif\n#endif\n}\n#else\nposition.xyz+=POSITION_BS0*renderer_BlendShapeWeights[0];position.xyz+=POSITION_BS1*renderer_BlendShapeWeights[1];\n#if defined( RENDERER_BLENDSHAPE_HAS_NORMAL ) && defined( RENDERER_BLENDSHAPE_HAS_TANGENT )\n#ifndef MATERIAL_OMIT_NORMAL\n#ifdef RENDERER_HAS_NORMAL\nnormal+=NORMAL_BS0*renderer_BlendShapeWeights[0];normal+=NORMAL_BS1*renderer_BlendShapeWeights[1];\n#endif\n#if defined( RENDERER_HAS_TANGENT ) && ( defined(MATERIAL_HAS_NORMALTEXTURE) || defined(MATERIAL_HAS_CLEAR_COAT_NORMAL_TEXTURE) )\ntangent.xyz+=TANGENT_BS0*renderer_BlendShapeWeights[0];tangent.xyz+=TANGENT_BS1*renderer_BlendShapeWeights[1];\n#endif\n#endif\n#else\n#if defined( RENDERER_BLENDSHAPE_HAS_NORMAL ) || defined( RENDERER_BLENDSHAPE_HAS_TANGENT )\n#ifndef MATERIAL_OMIT_NORMAL\nposition.xyz+=POSITION_BS2*renderer_BlendShapeWeights[2];position.xyz+=POSITION_BS3*renderer_BlendShapeWeights[3];\n#if defined( RENDERER_BLENDSHAPE_HAS_NORMAL ) && defined( RENDERER_HAS_NORMAL )\nnormal+=NORMAL_BS0*renderer_BlendShapeWeights[0];normal+=NORMAL_BS1*renderer_BlendShapeWeights[1];normal+=NORMAL_BS2*renderer_BlendShapeWeights[2];normal+=NORMAL_BS3*renderer_BlendShapeWeights[3];\n#endif\n#if defined(RENDERER_BLENDSHAPE_HAS_TANGENT) && defined( RENDERER_HAS_TANGENT ) && ( defined(MATERIAL_HAS_NORMALTEXTURE) || defined(MATERIAL_HAS_CLEAR_COAT_NORMAL_TEXTURE) )\ntangent.xyz+=TANGENT_BS0*renderer_BlendShapeWeights[0];tangent.xyz+=TANGENT_BS1*renderer_BlendShapeWeights[1];tangent.xyz+=TANGENT_BS2*renderer_BlendShapeWeights[2];tangent.xyz+=TANGENT_BS3*renderer_BlendShapeWeights[3];\n#endif\n#endif\n#else\nposition.xyz+=POSITION_BS2*renderer_BlendShapeWeights[2];position.xyz+=POSITION_BS3*renderer_BlendShapeWeights[3];position.xyz+=POSITION_BS4*renderer_BlendShapeWeights[4];position.xyz+=POSITION_BS5*renderer_BlendShapeWeights[5];position.xyz+=POSITION_BS6*renderer_BlendShapeWeights[6];position.xyz+=POSITION_BS7*renderer_BlendShapeWeights[7];\n#endif\n#endif\n#endif\n#endif\n"; // eslint-disable-line
 
-var color_vert = "#define GLSLIFY 1\n#ifdef RENDERER_HAS_VERTEXCOLOR\nv_color=COLOR_0;\n#endif\n"; // eslint-disable-line
+var color_vert = "#define GLSLIFY 1\n#ifdef RENDERER_ENABLE_VERTEXCOLOR\nv_color=COLOR_0;\n#endif\n"; // eslint-disable-line
 
 var FogVertex = "#define GLSLIFY 1\n#if SCENE_FOG_MODE != 0\nvec4 positionVS=renderer_MVMat*position;v_positionVS=positionVS.xyz/positionVS.w;\n#endif\n"; // eslint-disable-line
 
@@ -9543,11 +9592,11 @@ var light_frag_define = "#define GLSLIFY 1\n#ifdef SCENE_DIRECT_LIGHT_COUNT\nstr
 
 var mobile_material_frag = "#define GLSLIFY 1\nuniform vec4 material_EmissiveColor;uniform vec4 material_BaseColor;uniform vec4 material_SpecularColor;uniform float material_Shininess;uniform float material_NormalIntensity;uniform float material_AlphaCutoff;\n#ifdef MATERIAL_HAS_EMISSIVETEXTURE\nuniform sampler2D material_EmissiveTexture;\n#endif\n#ifdef MATERIAL_HAS_BASETEXTURE\nuniform sampler2D material_BaseTexture;\n#endif\n#ifdef MATERIAL_HAS_SPECULAR_TEXTURE\nuniform sampler2D material_SpecularTexture;\n#endif\n#ifdef MATERIAL_HAS_NORMALTEXTURE\nuniform sampler2D material_NormalTexture;\n#endif\n"; // eslint-disable-line
 
-var begin_mobile_frag = "#define GLSLIFY 1\nvec4 ambient=vec4(0.0);vec4 emission=material_EmissiveColor;vec4 diffuse=material_BaseColor;vec4 specular=material_SpecularColor;\n#ifdef MATERIAL_HAS_EMISSIVETEXTURE\nvec4 emissiveTextureColor=texture2D(material_EmissiveTexture,v_uv);\n#ifndef ENGINE_IS_COLORSPACE_GAMMA\nemissiveTextureColor=gammaToLinear(emissiveTextureColor);\n#endif\nemission*=emissiveTextureColor;\n#endif\n#ifdef MATERIAL_HAS_BASETEXTURE\nvec4 diffuseTextureColor=texture2D(material_BaseTexture,v_uv);\n#ifndef ENGINE_IS_COLORSPACE_GAMMA\ndiffuseTextureColor=gammaToLinear(diffuseTextureColor);\n#endif\ndiffuse*=diffuseTextureColor;\n#endif\n#ifdef RENDERER_HAS_VERTEXCOLOR\ndiffuse*=v_color;\n#endif\n#ifdef MATERIAL_HAS_SPECULAR_TEXTURE\nvec4 specularTextureColor=texture2D(material_SpecularTexture,v_uv);\n#ifndef ENGINE_IS_COLORSPACE_GAMMA\nspecularTextureColor=gammaToLinear(specularTextureColor);\n#endif\nspecular*=specularTextureColor;\n#endif\nambient=vec4(scene_EnvMapLight.diffuse*scene_EnvMapLight.diffuseIntensity,1.0)*diffuse;"; // eslint-disable-line
+var begin_mobile_frag = "#define GLSLIFY 1\nvec4 ambient=vec4(0.0);vec4 emission=material_EmissiveColor;vec4 diffuse=material_BaseColor;vec4 specular=material_SpecularColor;\n#ifdef MATERIAL_HAS_EMISSIVETEXTURE\nvec4 emissiveTextureColor=texture2D(material_EmissiveTexture,v_uv);\n#ifndef ENGINE_IS_COLORSPACE_GAMMA\nemissiveTextureColor=gammaToLinear(emissiveTextureColor);\n#endif\nemission*=emissiveTextureColor;\n#endif\n#ifdef MATERIAL_HAS_BASETEXTURE\nvec4 diffuseTextureColor=texture2D(material_BaseTexture,v_uv);\n#ifndef ENGINE_IS_COLORSPACE_GAMMA\ndiffuseTextureColor=gammaToLinear(diffuseTextureColor);\n#endif\ndiffuse*=diffuseTextureColor;\n#endif\n#ifdef RENDERER_ENABLE_VERTEXCOLOR\ndiffuse*=v_color;\n#endif\n#ifdef MATERIAL_HAS_SPECULAR_TEXTURE\nvec4 specularTextureColor=texture2D(material_SpecularTexture,v_uv);\n#ifndef ENGINE_IS_COLORSPACE_GAMMA\nspecularTextureColor=gammaToLinear(specularTextureColor);\n#endif\nspecular*=specularTextureColor;\n#endif\nambient=vec4(scene_EnvMapLight.diffuse*scene_EnvMapLight.diffuseIntensity,1.0)*diffuse;"; // eslint-disable-line
 
 var begin_viewdir_frag = "#define GLSLIFY 1\n#ifdef MATERIAL_NEED_WORLD_POS\nvec3 V=normalize(camera_Position-v_pos);\n#endif\n"; // eslint-disable-line
 
-var mobile_blinnphong_frag = "#define GLSLIFY 1\n#ifdef MATERIAL_HAS_NORMALTEXTURE\nmat3 tbn=getTBN();vec3 N=getNormalByNormalTexture(tbn,material_NormalTexture,material_NormalIntensity,v_uv);\n#else\nvec3 N=getNormal();\n#endif\nvec3 lightDiffuse=vec3(0.0,0.0,0.0);vec3 lightSpecular=vec3(0.0,0.0,0.0);float shadowAttenuation=1.0;\n#ifdef SCENE_DIRECT_LIGHT_COUNT\nshadowAttenuation=1.0;\n#ifdef SCENE_IS_CALCULATE_SHADOWS\nshadowAttenuation*=sampleShadowMap();int sunIndex=int(scene_ShadowInfo.z);\n#endif\nDirectLight directionalLight;for(int i=0;i<SCENE_DIRECT_LIGHT_COUNT;i++){if(isRendererCulledByLight(renderer_Layer.xy,scene_DirectLightCullingMask[i]))continue;directionalLight.color=scene_DirectLightColor[i];\n#ifdef SCENE_IS_CALCULATE_SHADOWS\nif(i==sunIndex){directionalLight.color*=shadowAttenuation;}\n#endif\ndirectionalLight.direction=scene_DirectLightDirection[i];float d=max(dot(N,-directionalLight.direction),0.0);lightDiffuse+=directionalLight.color*d;vec3 halfDir=normalize(V-directionalLight.direction);float s=pow(clamp(dot(N,halfDir),0.0,1.0),material_Shininess);lightSpecular+=directionalLight.color*s;}\n#endif\n#ifdef SCENE_POINT_LIGHT_COUNT\nPointLight pointLight;for(int i=0;i<SCENE_POINT_LIGHT_COUNT;i++){if(isRendererCulledByLight(renderer_Layer.xy,scene_PointLightCullingMask[i]))continue;pointLight.color=scene_PointLightColor[i];pointLight.position=scene_PointLightPosition[i];pointLight.distance=scene_PointLightDistance[i];vec3 direction=v_pos-pointLight.position;float dist=length(direction);direction/=dist;float decay=clamp(1.0-pow(dist/pointLight.distance,4.0),0.0,1.0);float d=max(dot(N,-direction),0.0)*decay;lightDiffuse+=pointLight.color*d;vec3 halfDir=normalize(V-direction);float s=pow(clamp(dot(N,halfDir),0.0,1.0),material_Shininess)*decay;lightSpecular+=pointLight.color*s;}\n#endif\n#ifdef SCENE_SPOT_LIGHT_COUNT\nSpotLight spotLight;for(int i=0;i<SCENE_SPOT_LIGHT_COUNT;i++){if(isRendererCulledByLight(renderer_Layer.xy,scene_SpotLightCullingMask[i]))continue;spotLight.color=scene_SpotLightColor[i];spotLight.position=scene_SpotLightPosition[i];spotLight.direction=scene_SpotLightDirection[i];spotLight.distance=scene_SpotLightDistance[i];spotLight.angleCos=scene_SpotLightAngleCos[i];spotLight.penumbraCos=scene_SpotLightPenumbraCos[i];vec3 direction=spotLight.position-v_pos;float lightDistance=length(direction);direction/=lightDistance;float angleCos=dot(direction,-spotLight.direction);float decay=clamp(1.0-pow(lightDistance/spotLight.distance,4.0),0.0,1.0);float spotEffect=smoothstep(spotLight.penumbraCos,spotLight.angleCos,angleCos);float decayTotal=decay*spotEffect;float d=max(dot(N,direction),0.0)*decayTotal;lightDiffuse+=spotLight.color*d;vec3 halfDir=normalize(V+direction);float s=pow(clamp(dot(N,halfDir),0.0,1.0),material_Shininess)*decayTotal;lightSpecular+=spotLight.color*s;}\n#endif\ndiffuse*=vec4(lightDiffuse,1.0);specular*=vec4(lightSpecular,1.0);\n#ifdef MATERIAL_IS_ALPHA_CUTOFF\nif(diffuse.a<material_AlphaCutoff){discard;}\n#endif\n"; // eslint-disable-line
+var mobile_blinnphong_frag = "#define GLSLIFY 1\n#ifdef MATERIAL_HAS_NORMALTEXTURE\nmat3 tbn=getTBN(gl_FrontFacing);vec3 N=getNormalByNormalTexture(tbn,material_NormalTexture,material_NormalIntensity,v_uv,gl_FrontFacing);\n#else\nvec3 N=getNormal(gl_FrontFacing);\n#endif\nvec3 lightDiffuse=vec3(0.0,0.0,0.0);vec3 lightSpecular=vec3(0.0,0.0,0.0);float shadowAttenuation=1.0;\n#ifdef SCENE_DIRECT_LIGHT_COUNT\nshadowAttenuation=1.0;\n#ifdef SCENE_IS_CALCULATE_SHADOWS\nshadowAttenuation*=sampleShadowMap();int sunIndex=int(scene_ShadowInfo.z);\n#endif\nDirectLight directionalLight;for(int i=0;i<SCENE_DIRECT_LIGHT_COUNT;i++){if(isRendererCulledByLight(renderer_Layer.xy,scene_DirectLightCullingMask[i]))continue;directionalLight.color=scene_DirectLightColor[i];\n#ifdef SCENE_IS_CALCULATE_SHADOWS\nif(i==sunIndex){directionalLight.color*=shadowAttenuation;}\n#endif\ndirectionalLight.direction=scene_DirectLightDirection[i];float d=max(dot(N,-directionalLight.direction),0.0);lightDiffuse+=directionalLight.color*d;vec3 halfDir=normalize(V-directionalLight.direction);float s=pow(clamp(dot(N,halfDir),0.0,1.0),material_Shininess);lightSpecular+=directionalLight.color*s;}\n#endif\n#ifdef SCENE_POINT_LIGHT_COUNT\nPointLight pointLight;for(int i=0;i<SCENE_POINT_LIGHT_COUNT;i++){if(isRendererCulledByLight(renderer_Layer.xy,scene_PointLightCullingMask[i]))continue;pointLight.color=scene_PointLightColor[i];pointLight.position=scene_PointLightPosition[i];pointLight.distance=scene_PointLightDistance[i];vec3 direction=v_pos-pointLight.position;float dist=length(direction);direction/=dist;float decay=clamp(1.0-pow(dist/pointLight.distance,4.0),0.0,1.0);float d=max(dot(N,-direction),0.0)*decay;lightDiffuse+=pointLight.color*d;vec3 halfDir=normalize(V-direction);float s=pow(clamp(dot(N,halfDir),0.0,1.0),material_Shininess)*decay;lightSpecular+=pointLight.color*s;}\n#endif\n#ifdef SCENE_SPOT_LIGHT_COUNT\nSpotLight spotLight;for(int i=0;i<SCENE_SPOT_LIGHT_COUNT;i++){if(isRendererCulledByLight(renderer_Layer.xy,scene_SpotLightCullingMask[i]))continue;spotLight.color=scene_SpotLightColor[i];spotLight.position=scene_SpotLightPosition[i];spotLight.direction=scene_SpotLightDirection[i];spotLight.distance=scene_SpotLightDistance[i];spotLight.angleCos=scene_SpotLightAngleCos[i];spotLight.penumbraCos=scene_SpotLightPenumbraCos[i];vec3 direction=spotLight.position-v_pos;float lightDistance=length(direction);direction/=lightDistance;float angleCos=dot(direction,-spotLight.direction);float decay=clamp(1.0-pow(lightDistance/spotLight.distance,4.0),0.0,1.0);float spotEffect=smoothstep(spotLight.penumbraCos,spotLight.angleCos,angleCos);float decayTotal=decay*spotEffect;float d=max(dot(N,direction),0.0)*decayTotal;lightDiffuse+=spotLight.color*d;vec3 halfDir=normalize(V+direction);float s=pow(clamp(dot(N,halfDir),0.0,1.0),material_Shininess)*decayTotal;lightSpecular+=spotLight.color*s;}\n#endif\ndiffuse*=vec4(lightDiffuse,1.0);specular*=vec4(lightSpecular,1.0);\n#ifdef MATERIAL_IS_ALPHA_CUTOFF\nif(diffuse.a<material_AlphaCutoff){discard;}\n#endif\n"; // eslint-disable-line
 
 var noise_cellular = "#define GLSLIFY 1\n#include <noise_cellular_2D>\n#include <noise_cellular_3D>\n#include <noise_cellular_2x2>\n#include <noise_cellular_2x2x2>\n"; // eslint-disable-line
 
@@ -9581,9 +9630,9 @@ var noise_simplex_3D_grad = "#define GLSLIFY 1\nfloat simplex(vec3 v,out vec3 gr
 
 var noise_simplex_4D = "#define GLSLIFY 1\nvec4 grad4(float j,vec4 ip){const vec4 ones=vec4(1.0,1.0,1.0,-1.0);vec4 p,s;p.xyz=floor(fract(vec3(j)*ip.xyz)*7.0)*ip.z-1.0;p.w=1.5-dot(abs(p.xyz),ones.xyz);s=vec4(lessThan(p,vec4(0.0)));p.xyz=p.xyz+(s.xyz*2.0-1.0)*s.www;return p;}\n#define F4 0.309016994374947451\nfloat simplex(vec4 v){const vec4 C=vec4(0.138196601125011,0.276393202250021,0.414589803375032,-0.447213595499958);vec4 i=floor(v+dot(v,vec4(F4)));vec4 x0=v-i+dot(i,C.xxxx);vec4 i0;vec3 isX=step(x0.yzw,x0.xxx);vec3 isYZ=step(x0.zww,x0.yyz);i0.x=isX.x+isX.y+isX.z;i0.yzw=1.0-isX;i0.y+=isYZ.x+isYZ.y;i0.zw+=1.0-isYZ.xy;i0.z+=isYZ.z;i0.w+=1.0-isYZ.z;vec4 i3=clamp(i0,0.0,1.0);vec4 i2=clamp(i0-1.0,0.0,1.0);vec4 i1=clamp(i0-2.0,0.0,1.0);vec4 x1=x0-i1+C.xxxx;vec4 x2=x0-i2+C.yyyy;vec4 x3=x0-i3+C.zzzz;vec4 x4=x0+C.wwww;i=mod289(i);float j0=permute(permute(permute(permute(i.w)+i.z)+i.y)+i.x);vec4 j1=permute(permute(permute(permute(i.w+vec4(i1.w,i2.w,i3.w,1.0))+i.z+vec4(i1.z,i2.z,i3.z,1.0))+i.y+vec4(i1.y,i2.y,i3.y,1.0))+i.x+vec4(i1.x,i2.x,i3.x,1.0));vec4 ip=vec4(1.0/294.0,1.0/49.0,1.0/7.0,0.0);vec4 p0=grad4(j0,ip);vec4 p1=grad4(j1.x,ip);vec4 p2=grad4(j1.y,ip);vec4 p3=grad4(j1.z,ip);vec4 p4=grad4(j1.w,ip);vec4 norm=taylorInvSqrt(vec4(dot(p0,p0),dot(p1,p1),dot(p2,p2),dot(p3,p3)));p0*=norm.x;p1*=norm.y;p2*=norm.z;p3*=norm.w;p4*=taylorInvSqrt(dot(p4,p4));vec3 m0=max(0.6-vec3(dot(x0,x0),dot(x1,x1),dot(x2,x2)),0.0);vec2 m1=max(0.6-vec2(dot(x3,x3),dot(x4,x4)),0.0);m0=m0*m0;m1=m1*m1;return 49.0*(dot(m0*m0,vec3(dot(p0,x0),dot(p1,x1),dot(p2,x2)))+dot(m1*m1,vec2(dot(p3,x3),dot(p4,x4))));}"; // eslint-disable-line
 
-var pbr_frag_define = "#define GLSLIFY 1\nuniform float material_AlphaCutoff;uniform vec4 material_BaseColor;uniform float material_Metal;uniform float material_Roughness;uniform vec3 material_PBRSpecularColor;uniform float material_Glossiness;uniform vec3 material_EmissiveColor;\n#ifdef MATERIAL_ENABLE_CLEAR_COAT\nuniform float material_ClearCoat;uniform float material_ClearCoatRoughness;\n#endif\nuniform float material_NormalIntensity;uniform float material_OcclusionIntensity;uniform float material_OcclusionTextureCoord;\n#ifdef MATERIAL_HAS_BASETEXTURE\nuniform sampler2D material_BaseTexture;\n#endif\n#ifdef MATERIAL_HAS_NORMALTEXTURE\nuniform sampler2D material_NormalTexture;\n#endif\n#ifdef MATERIAL_HAS_EMISSIVETEXTURE\nuniform sampler2D MATERIAL_HAS_EMISSIVETEXTURE;\n#endif\n#ifdef MATERIAL_HAS_ROUGHNESS_METALLIC_TEXTURE\nuniform sampler2D material_RoughnessMetallicTexture;\n#endif\n#ifdef MATERIAL_HAS_SPECULAR_GLOSSINESS_TEXTURE\nuniform sampler2D material_SpecularGlossinessTexture;\n#endif\n#ifdef MATERIAL_HAS_OCCLUSION_TEXTURE\nuniform sampler2D material_OcclusionTexture;\n#endif\n#ifdef MATERIAL_HAS_CLEAR_COAT_TEXTURE\nuniform sampler2D material_ClearCoatTexture;\n#endif\n#ifdef MATERIAL_HAS_CLEAR_COAT_ROUGHNESS_TEXTURE\nuniform sampler2D material_ClearCoatRoughnessTexture;\n#endif\n#ifdef MATERIAL_HAS_CLEAR_COAT_NORMAL_TEXTURE\nuniform sampler2D material_ClearCoatNormalTexture;\n#endif\nstruct ReflectedLight{vec3 directDiffuse;vec3 directSpecular;vec3 indirectDiffuse;vec3 indirectSpecular;};struct Geometry{vec3 position;vec3 normal;vec3 viewDir;float dotNV;\n#ifdef MATERIAL_ENABLE_CLEAR_COAT\nvec3 clearCoatNormal;float clearCoatDotNV;\n#endif\n};struct Material{vec3 diffuseColor;float roughness;vec3 specularColor;float opacity;\n#ifdef MATERIAL_ENABLE_CLEAR_COAT\nfloat clearCoat;float clearCoatRoughness;\n#endif\n};"; // eslint-disable-line
+var pbr_frag_define = "#define GLSLIFY 1\nuniform float material_AlphaCutoff;uniform vec4 material_BaseColor;uniform float material_Metal;uniform float material_Roughness;uniform float material_IOR;uniform vec3 material_PBRSpecularColor;uniform float material_Glossiness;uniform vec3 material_EmissiveColor;\n#ifdef MATERIAL_ENABLE_CLEAR_COAT\nuniform float material_ClearCoat;uniform float material_ClearCoatRoughness;\n#endif\nuniform float material_NormalIntensity;uniform float material_OcclusionIntensity;uniform float material_OcclusionTextureCoord;\n#ifdef MATERIAL_HAS_BASETEXTURE\nuniform sampler2D material_BaseTexture;\n#endif\n#ifdef MATERIAL_HAS_NORMALTEXTURE\nuniform sampler2D material_NormalTexture;\n#endif\n#ifdef MATERIAL_HAS_EMISSIVETEXTURE\nuniform sampler2D material_EmissiveTexture;\n#endif\n#ifdef MATERIAL_HAS_ROUGHNESS_METALLIC_TEXTURE\nuniform sampler2D material_RoughnessMetallicTexture;\n#endif\n#ifdef MATERIAL_HAS_SPECULAR_GLOSSINESS_TEXTURE\nuniform sampler2D material_SpecularGlossinessTexture;\n#endif\n#ifdef MATERIAL_HAS_OCCLUSION_TEXTURE\nuniform sampler2D material_OcclusionTexture;\n#endif\n#ifdef MATERIAL_HAS_CLEAR_COAT_TEXTURE\nuniform sampler2D material_ClearCoatTexture;\n#endif\n#ifdef MATERIAL_HAS_CLEAR_COAT_ROUGHNESS_TEXTURE\nuniform sampler2D material_ClearCoatRoughnessTexture;\n#endif\n#ifdef MATERIAL_HAS_CLEAR_COAT_NORMAL_TEXTURE\nuniform sampler2D material_ClearCoatNormalTexture;\n#endif\nstruct ReflectedLight{vec3 directDiffuse;vec3 directSpecular;vec3 indirectDiffuse;vec3 indirectSpecular;};struct Geometry{vec3 position;vec3 normal;vec3 viewDir;float dotNV;\n#ifdef MATERIAL_ENABLE_CLEAR_COAT\nvec3 clearCoatNormal;float clearCoatDotNV;\n#endif\n};struct Material{vec3 diffuseColor;float roughness;vec3 specularColor;float opacity;\n#ifdef MATERIAL_ENABLE_CLEAR_COAT\nfloat clearCoat;float clearCoatRoughness;\n#endif\n};"; // eslint-disable-line
 
-var pbr_helper = "#define GLSLIFY 1\n#include <normal_get>\nfloat computeSpecularOcclusion(float ambientOcclusion,float roughness,float dotNV){return saturate(pow(dotNV+ambientOcclusion,exp2(-16.0*roughness-1.0))-1.0+ambientOcclusion);}float getAARoughnessFactor(vec3 normal){\n#ifdef HAS_DERIVATIVES\nvec3 dxy=max(abs(dFdx(normal)),abs(dFdy(normal)));return 0.04+max(max(dxy.x,dxy.y),dxy.z);\n#else\nreturn 0.04;\n#endif\n}void initGeometry(out Geometry geometry){geometry.position=v_pos;geometry.viewDir=normalize(camera_Position-v_pos);\n#if defined(MATERIAL_HAS_NORMALTEXTURE) || defined(MATERIAL_HAS_CLEAR_COAT_NORMAL_TEXTURE)\nmat3 tbn=getTBN();\n#endif\n#ifdef MATERIAL_HAS_NORMALTEXTURE\ngeometry.normal=getNormalByNormalTexture(tbn,material_NormalTexture,material_NormalIntensity,v_uv);\n#else\ngeometry.normal=getNormal();\n#endif\ngeometry.dotNV=saturate(dot(geometry.normal,geometry.viewDir));\n#ifdef MATERIAL_ENABLE_CLEAR_COAT\n#ifdef MATERIAL_HAS_CLEAR_COAT_NORMAL_TEXTURE\ngeometry.clearCoatNormal=getNormalByNormalTexture(tbn,material_ClearCoatNormalTexture,material_NormalIntensity,v_uv);\n#else\ngeometry.clearCoatNormal=getNormal();\n#endif\ngeometry.clearCoatDotNV=saturate(dot(geometry.clearCoatNormal,geometry.viewDir));\n#endif\n}void initMaterial(out Material material,const in Geometry geometry){vec4 baseColor=material_BaseColor;float metal=material_Metal;float roughness=material_Roughness;vec3 specularColor=material_PBRSpecularColor;float glossiness=material_Glossiness;float alphaCutoff=material_AlphaCutoff;\n#ifdef MATERIAL_HAS_BASETEXTURE\nvec4 baseTextureColor=texture2D(material_BaseTexture,v_uv);\n#ifndef ENGINE_IS_COLORSPACE_GAMMA\nbaseTextureColor=gammaToLinear(baseTextureColor);\n#endif\nbaseColor*=baseTextureColor;\n#endif\n#ifdef RENDERER_HAS_VERTEXCOLOR\nbaseColor*=v_color;\n#endif\n#ifdef MATERIAL_IS_ALPHA_CUTOFF\nif(baseColor.a<alphaCutoff){discard;}\n#endif\n#ifdef MATERIAL_HAS_ROUGHNESS_METALLIC_TEXTURE\nvec4 metalRoughMapColor=texture2D(material_RoughnessMetallicTexture,v_uv);roughness*=metalRoughMapColor.g;metal*=metalRoughMapColor.b;\n#endif\n#ifdef MATERIAL_HAS_SPECULAR_GLOSSINESS_TEXTURE\nvec4 specularGlossinessColor=texture2D(material_SpecularGlossinessTexture,v_uv);\n#ifndef ENGINE_IS_COLORSPACE_GAMMA\nspecularGlossinessColor=gammaToLinear(specularGlossinessColor);\n#endif\nspecularColor*=specularGlossinessColor.rgb;glossiness*=specularGlossinessColor.a;\n#endif\n#ifdef IS_METALLIC_WORKFLOW\nmaterial.diffuseColor=baseColor.rgb*(1.0-metal);material.specularColor=mix(vec3(0.04),baseColor.rgb,metal);material.roughness=roughness;\n#else\nfloat specularStrength=max(max(specularColor.r,specularColor.g),specularColor.b);material.diffuseColor=baseColor.rgb*(1.0-specularStrength);material.specularColor=specularColor;material.roughness=1.0-glossiness;\n#endif\nmaterial.roughness=max(material.roughness,getAARoughnessFactor(geometry.normal));\n#ifdef MATERIAL_ENABLE_CLEAR_COAT\nmaterial.clearCoat=material_ClearCoat;material.clearCoatRoughness=material_ClearCoatRoughness;\n#ifdef MATERIAL_HAS_CLEAR_COAT_TEXTURE\nmaterial.clearCoat*=texture2D(material_ClearCoatTexture,v_uv).r;\n#endif\n#ifdef MATERIAL_HAS_CLEAR_COAT_ROUGHNESS_TEXTURE\nmaterial.clearCoatRoughness*=texture2D(material_ClearCoatRoughnessTexture,v_uv).g;\n#endif\nmaterial.clearCoat=saturate(material.clearCoat);material.clearCoatRoughness=max(material.clearCoatRoughness,getAARoughnessFactor(geometry.clearCoatNormal));\n#endif\n#ifdef MATERIAL_IS_TRANSPARENT\nmaterial.opacity=baseColor.a;\n#else\nmaterial.opacity=1.0;\n#endif\n}\n#include <brdf>\n#include <direct_irradiance_frag_define>\n#include <ibl_frag_define>\n"; // eslint-disable-line
+var pbr_helper = "#define GLSLIFY 1\n#include <normal_get>\nfloat computeSpecularOcclusion(float ambientOcclusion,float roughness,float dotNV){return saturate(pow(dotNV+ambientOcclusion,exp2(-16.0*roughness-1.0))-1.0+ambientOcclusion);}float getAARoughnessFactor(vec3 normal){\n#ifdef HAS_DERIVATIVES\nvec3 dxy=max(abs(dFdx(normal)),abs(dFdy(normal)));return 0.04+max(max(dxy.x,dxy.y),dxy.z);\n#else\nreturn 0.04;\n#endif\n}void initGeometry(out Geometry geometry,bool isFrontFacing){geometry.position=v_pos;geometry.viewDir=normalize(camera_Position-v_pos);\n#if defined(MATERIAL_HAS_NORMALTEXTURE) || defined(MATERIAL_HAS_CLEAR_COAT_NORMAL_TEXTURE)\nmat3 tbn=getTBN(isFrontFacing);\n#endif\n#ifdef MATERIAL_HAS_NORMALTEXTURE\ngeometry.normal=getNormalByNormalTexture(tbn,material_NormalTexture,material_NormalIntensity,v_uv,isFrontFacing);\n#else\ngeometry.normal=getNormal(isFrontFacing);\n#endif\ngeometry.dotNV=saturate(dot(geometry.normal,geometry.viewDir));\n#ifdef MATERIAL_ENABLE_CLEAR_COAT\n#ifdef MATERIAL_HAS_CLEAR_COAT_NORMAL_TEXTURE\ngeometry.clearCoatNormal=getNormalByNormalTexture(tbn,material_ClearCoatNormalTexture,material_NormalIntensity,v_uv,isFrontFacing);\n#else\ngeometry.clearCoatNormal=getNormal(isFrontFacing);\n#endif\ngeometry.clearCoatDotNV=saturate(dot(geometry.clearCoatNormal,geometry.viewDir));\n#endif\n}void initMaterial(out Material material,const in Geometry geometry){vec4 baseColor=material_BaseColor;float metal=material_Metal;float roughness=material_Roughness;vec3 specularColor=material_PBRSpecularColor;float glossiness=material_Glossiness;float alphaCutoff=material_AlphaCutoff;float F0=pow2((material_IOR-1.0)/(material_IOR+1.0));\n#ifdef MATERIAL_HAS_BASETEXTURE\nvec4 baseTextureColor=texture2D(material_BaseTexture,v_uv);\n#ifndef ENGINE_IS_COLORSPACE_GAMMA\nbaseTextureColor=gammaToLinear(baseTextureColor);\n#endif\nbaseColor*=baseTextureColor;\n#endif\n#ifdef RENDERER_ENABLE_VERTEXCOLOR\nbaseColor*=v_color;\n#endif\n#ifdef MATERIAL_IS_ALPHA_CUTOFF\nif(baseColor.a<alphaCutoff){discard;}\n#endif\n#ifdef MATERIAL_HAS_ROUGHNESS_METALLIC_TEXTURE\nvec4 metalRoughMapColor=texture2D(material_RoughnessMetallicTexture,v_uv);roughness*=metalRoughMapColor.g;metal*=metalRoughMapColor.b;\n#endif\n#ifdef MATERIAL_HAS_SPECULAR_GLOSSINESS_TEXTURE\nvec4 specularGlossinessColor=texture2D(material_SpecularGlossinessTexture,v_uv);\n#ifndef ENGINE_IS_COLORSPACE_GAMMA\nspecularGlossinessColor=gammaToLinear(specularGlossinessColor);\n#endif\nspecularColor*=specularGlossinessColor.rgb;glossiness*=specularGlossinessColor.a;\n#endif\n#ifdef IS_METALLIC_WORKFLOW\nmaterial.diffuseColor=baseColor.rgb*(1.0-metal);material.specularColor=mix(vec3(F0),baseColor.rgb,metal);material.roughness=roughness;\n#else\nfloat specularStrength=max(max(specularColor.r,specularColor.g),specularColor.b);material.diffuseColor=baseColor.rgb*(1.0-specularStrength);material.specularColor=specularColor;material.roughness=1.0-glossiness;\n#endif\nmaterial.roughness=max(material.roughness,getAARoughnessFactor(geometry.normal));\n#ifdef MATERIAL_ENABLE_CLEAR_COAT\nmaterial.clearCoat=material_ClearCoat;material.clearCoatRoughness=material_ClearCoatRoughness;\n#ifdef MATERIAL_HAS_CLEAR_COAT_TEXTURE\nmaterial.clearCoat*=texture2D(material_ClearCoatTexture,v_uv).r;\n#endif\n#ifdef MATERIAL_HAS_CLEAR_COAT_ROUGHNESS_TEXTURE\nmaterial.clearCoatRoughness*=texture2D(material_ClearCoatRoughnessTexture,v_uv).g;\n#endif\nmaterial.clearCoat=saturate(material.clearCoat);material.clearCoatRoughness=max(material.clearCoatRoughness,getAARoughnessFactor(geometry.clearCoatNormal));\n#endif\n#ifdef MATERIAL_IS_TRANSPARENT\nmaterial.opacity=baseColor.a;\n#else\nmaterial.opacity=1.0;\n#endif\n}\n#include <brdf>\n#include <direct_irradiance_frag_define>\n#include <ibl_frag_define>\n"; // eslint-disable-line
 
 var brdf = "#define GLSLIFY 1\nfloat F_Schlick(float dotLH){return 0.04+0.96*(pow(1.0-dotLH,5.0));}vec3 F_Schlick(vec3 specularColor,float dotLH){float fresnel=exp2((-5.55473*dotLH-6.98316)*dotLH);return(1.0-specularColor)*fresnel+specularColor;}float G_GGX_SmithCorrelated(float alpha,float dotNL,float dotNV){float a2=pow2(alpha);float gv=dotNL*sqrt(a2+(1.0-a2)*pow2(dotNV));float gl=dotNV*sqrt(a2+(1.0-a2)*pow2(dotNL));return 0.5/max(gv+gl,EPSILON);}float D_GGX(float alpha,float dotNH){float a2=pow2(alpha);float denom=pow2(dotNH)*(a2-1.0)+1.0;return RECIPROCAL_PI*a2/pow2(denom);}vec3 BRDF_Specular_GGX(vec3 incidentDirection,vec3 viewDir,vec3 normal,vec3 specularColor,float roughness){float alpha=pow2(roughness);vec3 halfDir=normalize(incidentDirection+viewDir);float dotNL=saturate(dot(normal,incidentDirection));float dotNV=saturate(dot(normal,viewDir));float dotNH=saturate(dot(normal,halfDir));float dotLH=saturate(dot(incidentDirection,halfDir));vec3 F=F_Schlick(specularColor,dotLH);float G=G_GGX_SmithCorrelated(alpha,dotNL,dotNV);float D=D_GGX(alpha,dotNH);return F*(G*D);}vec3 BRDF_Diffuse_Lambert(vec3 diffuseColor){return RECIPROCAL_PI*diffuseColor;}"; // eslint-disable-line
 
@@ -9591,7 +9640,7 @@ var direct_irradiance_frag_define = "#define GLSLIFY 1\n#include <ShadowFragment
 
 var ibl_frag_define = "#define GLSLIFY 1\nvec3 getLightProbeIrradiance(vec3 sh[9],vec3 normal){normal.x=-normal.x;vec3 result=sh[0]+sh[1]*(normal.y)+sh[2]*(normal.z)+sh[3]*(normal.x)+sh[4]*(normal.y*normal.x)+sh[5]*(normal.y*normal.z)+sh[6]*(3.0*normal.z*normal.z-1.0)+sh[7]*(normal.z*normal.x)+sh[8]*(normal.x*normal.x-normal.y*normal.y);return max(result,vec3(0.0));}vec3 envBRDFApprox(vec3 specularColor,float roughness,float dotNV){const vec4 c0=vec4(-1,-0.0275,-0.572,0.022);const vec4 c1=vec4(1,0.0425,1.04,-0.04);vec4 r=roughness*c0+c1;float a004=min(r.x*r.x,exp2(-9.28*dotNV))*r.x+r.y;vec2 AB=vec2(-1.04,1.04)*a004+r.zw;return specularColor*AB.x+AB.y;}float getSpecularMIPLevel(float roughness,int maxMIPLevel){return roughness*float(maxMIPLevel);}vec3 getLightProbeRadiance(vec3 viewDir,vec3 normal,float roughness,int maxMIPLevel,float specularIntensity){\n#ifndef SCENE_USE_SPECULAR_ENV\nreturn vec3(0);\n#else\nvec3 reflectVec=reflect(-viewDir,normal);reflectVec.x=-reflectVec.x;float specularMIPLevel=getSpecularMIPLevel(roughness,maxMIPLevel);\n#ifdef HAS_TEX_LOD\nvec4 envMapColor=textureCubeLodEXT(scene_EnvSpecularSampler,reflectVec,specularMIPLevel);\n#else\nvec4 envMapColor=textureCube(scene_EnvSpecularSampler,reflectVec,specularMIPLevel);\n#endif\n#ifdef SCENE_IS_DECODE_ENV_RGBM\nenvMapColor.rgb=RGBMToLinear(envMapColor,5.0).rgb;\n#ifdef ENGINE_IS_COLORSPACE_GAMMA\nenvMapColor=linearToGamma(envMapColor);\n#endif\n#else\n#ifndef ENGINE_IS_COLORSPACE_GAMMA\nenvMapColor=gammaToLinear(envMapColor);\n#endif\n#endif\nreturn envMapColor.rgb*specularIntensity;\n#endif\n}"; // eslint-disable-line
 
-var pbr_frag = "#define GLSLIFY 1\nGeometry geometry;Material material;ReflectedLight reflectedLight=ReflectedLight(vec3(0.0),vec3(0.0),vec3(0.0),vec3(0.0));initGeometry(geometry);initMaterial(material,geometry);addTotalDirectRadiance(geometry,material,reflectedLight);\n#ifdef SCENE_USE_SH\nvec3 irradiance=getLightProbeIrradiance(scene_EnvSH,geometry.normal);\n#ifdef ENGINE_IS_COLORSPACE_GAMMA\nirradiance=linearToGamma(vec4(irradiance,1.0)).rgb;\n#endif\nirradiance*=scene_EnvMapLight.diffuseIntensity;\n#else\nvec3 irradiance=scene_EnvMapLight.diffuse*scene_EnvMapLight.diffuseIntensity;irradiance*=PI;\n#endif\nreflectedLight.indirectDiffuse+=irradiance*BRDF_Diffuse_Lambert(material.diffuseColor);vec3 radiance=getLightProbeRadiance(geometry.viewDir,geometry.normal,material.roughness,int(scene_EnvMapLight.mipMapLevel),scene_EnvMapLight.specularIntensity);float radianceAttenuation=1.0;\n#ifdef MATERIAL_ENABLE_CLEAR_COAT\nvec3 clearCoatRadiance=getLightProbeRadiance(geometry.viewDir,geometry.clearCoatNormal,material.clearCoatRoughness,int(scene_EnvMapLight.mipMapLevel),scene_EnvMapLight.specularIntensity);reflectedLight.indirectSpecular+=clearCoatRadiance*material.clearCoat*envBRDFApprox(vec3(0.04),material.clearCoatRoughness,geometry.clearCoatDotNV);radianceAttenuation-=material.clearCoat*F_Schlick(geometry.clearCoatDotNV);\n#endif\nreflectedLight.indirectSpecular+=radianceAttenuation*radiance*envBRDFApprox(material.specularColor,material.roughness,geometry.dotNV);\n#ifdef MATERIAL_HAS_OCCLUSION_TEXTURE\nvec2 aoUV=v_uv;\n#ifdef RENDERER_HAS_UV1\nif(material_OcclusionTextureCoord==1.0){aoUV=v_uv1;}\n#endif\nfloat ambientOcclusion=(texture2D(material_OcclusionTexture,aoUV).r-1.0)*material_OcclusionIntensity+1.0;reflectedLight.indirectDiffuse*=ambientOcclusion;\n#ifdef SCENE_USE_SPECULAR_ENV\nreflectedLight.indirectSpecular*=computeSpecularOcclusion(ambientOcclusion,material.roughness,geometry.dotNV);\n#endif\n#endif\nvec3 emissiveRadiance=material_EmissiveColor;\n#ifdef MATERIAL_HAS_EMISSIVETEXTURE\nvec4 emissiveColor=texture2D(material_EmissiveTexture,v_uv);\n#ifndef ENGINE_IS_COLORSPACE_GAMMA\nemissiveColor=gammaToLinear(emissiveColor);\n#endif\nemissiveRadiance*=emissiveColor.rgb;\n#endif\nvec3 totalRadiance=reflectedLight.directDiffuse+reflectedLight.indirectDiffuse+reflectedLight.directSpecular+reflectedLight.indirectSpecular+emissiveRadiance;vec4 targetColor=vec4(totalRadiance,material.opacity);gl_FragColor=targetColor;"; // eslint-disable-line
+var pbr_frag = "#define GLSLIFY 1\nGeometry geometry;Material material;ReflectedLight reflectedLight=ReflectedLight(vec3(0.0),vec3(0.0),vec3(0.0),vec3(0.0));initGeometry(geometry,gl_FrontFacing);initMaterial(material,geometry);addTotalDirectRadiance(geometry,material,reflectedLight);\n#ifdef SCENE_USE_SH\nvec3 irradiance=getLightProbeIrradiance(scene_EnvSH,geometry.normal);\n#ifdef ENGINE_IS_COLORSPACE_GAMMA\nirradiance=linearToGamma(vec4(irradiance,1.0)).rgb;\n#endif\nirradiance*=scene_EnvMapLight.diffuseIntensity;\n#else\nvec3 irradiance=scene_EnvMapLight.diffuse*scene_EnvMapLight.diffuseIntensity;irradiance*=PI;\n#endif\nreflectedLight.indirectDiffuse+=irradiance*BRDF_Diffuse_Lambert(material.diffuseColor);vec3 radiance=getLightProbeRadiance(geometry.viewDir,geometry.normal,material.roughness,int(scene_EnvMapLight.mipMapLevel),scene_EnvMapLight.specularIntensity);float radianceAttenuation=1.0;\n#ifdef MATERIAL_ENABLE_CLEAR_COAT\nvec3 clearCoatRadiance=getLightProbeRadiance(geometry.viewDir,geometry.clearCoatNormal,material.clearCoatRoughness,int(scene_EnvMapLight.mipMapLevel),scene_EnvMapLight.specularIntensity);reflectedLight.indirectSpecular+=clearCoatRadiance*material.clearCoat*envBRDFApprox(vec3(0.04),material.clearCoatRoughness,geometry.clearCoatDotNV);radianceAttenuation-=material.clearCoat*F_Schlick(geometry.clearCoatDotNV);\n#endif\nreflectedLight.indirectSpecular+=radianceAttenuation*radiance*envBRDFApprox(material.specularColor,material.roughness,geometry.dotNV);\n#ifdef MATERIAL_HAS_OCCLUSION_TEXTURE\nvec2 aoUV=v_uv;\n#ifdef RENDERER_HAS_UV1\nif(material_OcclusionTextureCoord==1.0){aoUV=v_uv1;}\n#endif\nfloat ambientOcclusion=(texture2D(material_OcclusionTexture,aoUV).r-1.0)*material_OcclusionIntensity+1.0;reflectedLight.indirectDiffuse*=ambientOcclusion;\n#ifdef SCENE_USE_SPECULAR_ENV\nreflectedLight.indirectSpecular*=computeSpecularOcclusion(ambientOcclusion,material.roughness,geometry.dotNV);\n#endif\n#endif\nvec3 emissiveRadiance=material_EmissiveColor;\n#ifdef MATERIAL_HAS_EMISSIVETEXTURE\nvec4 emissiveColor=texture2D(material_EmissiveTexture,v_uv);\n#ifndef ENGINE_IS_COLORSPACE_GAMMA\nemissiveColor=gammaToLinear(emissiveColor);\n#endif\nemissiveRadiance*=emissiveColor.rgb;\n#endif\nvec3 totalRadiance=reflectedLight.directDiffuse+reflectedLight.indirectDiffuse+reflectedLight.directSpecular+reflectedLight.indirectSpecular+emissiveRadiance;vec4 targetColor=vec4(totalRadiance,material.opacity);gl_FragColor=targetColor;"; // eslint-disable-line
 
 var PBRShaderLib = {
     pbr_frag_define: pbr_frag_define,
@@ -9620,7 +9669,7 @@ var ShadowLib = {
     ShadowVertex: ShadowVertex
 };
 
-var normal_get = "#define GLSLIFY 1\nvec3 getNormal(){\n#ifdef RENDERER_HAS_NORMAL\nvec3 normal=normalize(v_normal);\n#elif defined(HAS_DERIVATIVES)\nvec3 pos_dx=dFdx(v_pos);vec3 pos_dy=dFdy(v_pos);vec3 normal=normalize(cross(pos_dx,pos_dy));\n#else\nvec3 normal=vec3(0,0,1);\n#endif\nnormal*=float(gl_FrontFacing)*2.0-1.0;return normal;}vec3 getNormalByNormalTexture(mat3 tbn,sampler2D normalTexture,float normalIntensity,vec2 uv){vec3 normal=texture2D(normalTexture,uv).rgb;normal=normalize(tbn*((2.0*normal-1.0)*vec3(normalIntensity,normalIntensity,1.0)));normal*=float(gl_FrontFacing)*2.0-1.0;return normal;}mat3 getTBN(){\n#if defined(RENDERER_HAS_NORMAL) && defined(RENDERER_HAS_TANGENT) && ( defined(MATERIAL_HAS_NORMALTEXTURE) || defined(MATERIAL_HAS_CLEAR_COAT_NORMAL_TEXTURE) )\nmat3 tbn=v_TBN;\n#else\nvec3 normal=getNormal();vec3 position=v_pos;vec2 uv=gl_FrontFacing? v_uv:-v_uv;\n#ifdef HAS_DERIVATIVES\nvec3 dp1=dFdx(position);vec3 dp2=dFdy(position);vec2 duv1=dFdx(uv);vec2 duv2=dFdy(uv);vec3 dp2perp=cross(dp2,normal);vec3 dp1perp=cross(normal,dp1);vec3 tangent=dp2perp*duv1.x+dp1perp*duv2.x;vec3 binormal=dp2perp*duv1.y+dp1perp*duv2.y;float invmax=inversesqrt(max(dot(tangent,tangent),dot(binormal,binormal)));mat3 tbn=mat3(tangent*invmax,binormal*invmax,normal);\n#else\nmat3 tbn=mat3(vec3(0.0),vec3(0.0),normal);\n#endif\n#endif\nreturn tbn;}"; // eslint-disable-line
+var normal_get = "#define GLSLIFY 1\nvec3 getNormal(bool isFrontFacing){\n#ifdef RENDERER_HAS_NORMAL\nvec3 normal=normalize(v_normal);\n#elif defined(HAS_DERIVATIVES)\nvec3 pos_dx=dFdx(v_pos);vec3 pos_dy=dFdy(v_pos);vec3 normal=normalize(cross(pos_dx,pos_dy));\n#else\nvec3 normal=vec3(0,0,1);\n#endif\nnormal*=float(isFrontFacing)*2.0-1.0;return normal;}vec3 getNormalByNormalTexture(mat3 tbn,sampler2D normalTexture,float normalIntensity,vec2 uv,bool isFrontFacing){vec3 normal=texture2D(normalTexture,uv).rgb;normal=normalize(tbn*((2.0*normal-1.0)*vec3(normalIntensity,normalIntensity,1.0)));normal*=float(isFrontFacing)*2.0-1.0;return normal;}mat3 getTBN(bool isFrontFacing){\n#if defined(RENDERER_HAS_NORMAL) && defined(RENDERER_HAS_TANGENT) && ( defined(MATERIAL_HAS_NORMALTEXTURE) || defined(MATERIAL_HAS_CLEAR_COAT_NORMAL_TEXTURE) )\nmat3 tbn=v_TBN;\n#else\nvec3 normal=getNormal(isFrontFacing);vec3 position=v_pos;vec2 uv=isFrontFacing? v_uv:-v_uv;\n#ifdef HAS_DERIVATIVES\nvec3 dp1=dFdx(position);vec3 dp2=dFdy(position);vec2 duv1=dFdx(uv);vec2 duv2=dFdy(uv);vec3 dp2perp=cross(dp2,normal);vec3 dp1perp=cross(normal,dp1);vec3 tangent=dp2perp*duv1.x+dp1perp*duv2.x;vec3 binormal=dp2perp*duv1.y+dp1perp*duv2.y;float invmax=inversesqrt(max(dot(tangent,tangent),dot(binormal,binormal)));mat3 tbn=mat3(tangent*invmax,binormal*invmax,normal);\n#else\nmat3 tbn=mat3(vec3(0.0),vec3(0.0),normal);\n#endif\n#endif\nreturn tbn;}"; // eslint-disable-line
 
 var ShaderLib = _extends({
     common: common,
@@ -10771,6 +10820,14 @@ exports.Renderer = (_Renderer = /*#__PURE__*/ function(Component) {
     };
     /**
    * @internal
+   */ _proto._cloneTo = function _cloneTo(target) {
+        var materials = this._materials;
+        for(var i = 0, n = materials.length; i < n; i++){
+            target._setMaterial(i, materials[i]);
+        }
+    };
+    /**
+   * @internal
    */ _proto._onDestroy = function _onDestroy() {
         Component.prototype._onDestroy.call(this);
         this.entity.transform._updateFlagManager.removeListener(this._onTransformChanged);
@@ -10781,14 +10838,18 @@ exports.Renderer = (_Renderer = /*#__PURE__*/ function(Component) {
             (_materials_i = materials[i]) == null ? void 0 : _materials_i._addReferCount(-1);
         }
     };
-    _proto._updateShaderData = function _updateShaderData(context) {
+    /**
+   * @internal
+   */ _proto._updateShaderData = function _updateShaderData(context) {
         var entity = this.entity;
         var worldMatrix = entity.transform.worldMatrix;
         this._updateTransformShaderData(context, worldMatrix);
         var layer = entity.layer;
         this._rendererLayer.set(layer & 65535, layer >>> 16 & 65535, 0, 0);
     };
-    _proto._updateTransformShaderData = function _updateTransformShaderData(context, worldMatrix) {
+    /**
+   * @internal
+   */ _proto._updateTransformShaderData = function _updateTransformShaderData(context, worldMatrix) {
         var shaderData = this.shaderData;
         var virtualCamera = context.virtualCamera;
         var mvMatrix = this._mvMatrix;
@@ -10807,14 +10868,22 @@ exports.Renderer = (_Renderer = /*#__PURE__*/ function(Component) {
         shaderData.setMatrix(exports.Renderer._mvInvMatrixProperty, mvInvMatrix);
         shaderData.setMatrix(exports.Renderer._normalMatrixProperty, normalMatrix);
     };
-    _proto._registerEntityTransformListener = function _registerEntityTransformListener() {
+    /**
+   * @internal
+   */ _proto._registerEntityTransformListener = function _registerEntityTransformListener() {
         this.entity.transform._updateFlagManager.addListener(this._onTransformChanged);
     };
-    _proto._updateBounds = function _updateBounds(worldBounds) {};
-    _proto._render = function _render(context) {
+    /**
+   * @internal
+   */ _proto._updateBounds = function _updateBounds(worldBounds) {};
+    /**
+   * @internal
+   */ _proto._render = function _render(context) {
         throw "not implement";
     };
-    _proto._createInstanceMaterial = function _createInstanceMaterial(material, index) {
+    /**
+   * @internal
+   */ _proto._createInstanceMaterial = function _createInstanceMaterial(material, index) {
         var insMaterial = material.clone();
         insMaterial.name = insMaterial.name + "(Instance)";
         material._addReferCount(-1);
@@ -10837,7 +10906,9 @@ exports.Renderer = (_Renderer = /*#__PURE__*/ function(Component) {
             materials[index] = material;
         }
     };
-    _proto._onTransformChanged = function _onTransformChanged(type) {
+    /**
+   * @internal
+   */ _proto._onTransformChanged = function _onTransformChanged(type) {
         this._dirtyUpdateFlag |= 0x1;
     };
     _create_class(Renderer1, [
@@ -10950,7 +11021,7 @@ __decorate([
     ignoreClone
 ], exports.Renderer.prototype, "_overrideUpdate", void 0);
 __decorate([
-    shallowClone
+    ignoreClone
 ], exports.Renderer.prototype, "_materials", void 0);
 __decorate([
     ignoreClone
@@ -11144,8 +11215,10 @@ SimpleSpriteAssembler = __decorate([
         _this = Renderer.call(this, entity) || this;
         /** The mask layers the sprite mask influence to. */ _this.influenceLayers = exports.SpriteMaskLayer.Everything;
         _this._sprite = null;
-        _this._width = undefined;
-        _this._height = undefined;
+        _this._automaticWidth = 0;
+        _this._automaticHeight = 0;
+        _this._customWidth = undefined;
+        _this._customHeight = undefined;
         _this._flipX = false;
         _this._flipY = false;
         _this._alphaCutoff = 0.5;
@@ -11160,30 +11233,33 @@ SimpleSpriteAssembler = __decorate([
     /**
    * @internal
    */ _proto._cloneTo = function _cloneTo(target) {
+        Renderer.prototype._cloneTo.call(this, target);
         target.sprite = this._sprite;
     };
-    _proto._updateBounds = function _updateBounds(worldBounds) {
-        var _this_sprite;
-        if (!((_this_sprite = this.sprite) == null ? void 0 : _this_sprite.texture) || !this.width || !this.height) {
+    /**
+   * @internal
+   */ _proto._updateBounds = function _updateBounds(worldBounds) {
+        if (this.sprite) {
+            SimpleSpriteAssembler.updatePositions(this);
+        } else {
             worldBounds.min.set(0, 0, 0);
             worldBounds.max.set(0, 0, 0);
-        } else {
-            SimpleSpriteAssembler.updatePositions(this);
         }
     };
     /**
+   * @internal
    * @inheritdoc
    */ _proto._render = function _render(context) {
         var _this_sprite;
         if (!((_this_sprite = this.sprite) == null ? void 0 : _this_sprite.texture) || !this.width || !this.height) {
             return;
         }
-        // Update position.
+        // Update position
         if (this._dirtyUpdateFlag & RendererUpdateFlags.WorldVolume) {
             SimpleSpriteAssembler.updatePositions(this);
             this._dirtyUpdateFlag &= ~RendererUpdateFlags.WorldVolume;
         }
-        // Update uv.
+        // Update uv
         if (this._dirtyUpdateFlag & 0x2) {
             SimpleSpriteAssembler.updateUVs(this);
             this._dirtyUpdateFlag &= ~0x2;
@@ -11197,19 +11273,39 @@ SimpleSpriteAssembler = __decorate([
         this._maskElement = renderElement;
     };
     /**
+   * @internal
    * @inheritdoc
    */ _proto._onDestroy = function _onDestroy() {
-        var _this__sprite;
         Renderer.prototype._onDestroy.call(this);
-        (_this__sprite = this._sprite) == null ? void 0 : _this__sprite._updateFlagManager.removeListener(this._onSpriteChange);
+        var sprite = this._sprite;
+        if (sprite) {
+            sprite._addReferCount(-1);
+            sprite._updateFlagManager.removeListener(this._onSpriteChange);
+        }
         this._sprite = null;
         this._verticesData = null;
     };
+    _proto._calDefaultSize = function _calDefaultSize() {
+        var sprite = this._sprite;
+        if (sprite) {
+            this._automaticWidth = sprite.width;
+            this._automaticHeight = sprite.height;
+        } else {
+            this._automaticWidth = this._automaticHeight = 0;
+        }
+        this._dirtyUpdateFlag &= ~0x4;
+    };
     _proto._onSpriteChange = function _onSpriteChange(type) {
         switch(type){
             case SpriteModifyFlags.texture:
                 this.shaderData.setTexture(SpriteMask._textureProperty, this.sprite.texture);
                 break;
+            case SpriteModifyFlags.size:
+                this._dirtyUpdateFlag |= 0x4;
+                if (this._customWidth === undefined || this._customHeight === undefined) {
+                    this._dirtyUpdateFlag |= RendererUpdateFlags.WorldVolume;
+                }
+                break;
             case SpriteModifyFlags.region:
             case SpriteModifyFlags.atlasRegionOffset:
                 this._dirtyUpdateFlag |= 0x3;
@@ -11217,22 +11313,31 @@ SimpleSpriteAssembler = __decorate([
             case SpriteModifyFlags.atlasRegion:
                 this._dirtyUpdateFlag |= 0x2;
                 break;
+            case SpriteModifyFlags.pivot:
+                this._dirtyUpdateFlag |= RendererUpdateFlags.WorldVolume;
+                break;
         }
     };
     _create_class(SpriteMask, [
         {
             key: "width",
             get: /**
-   * Render width.
+   * Render width (in world coordinates).
+   *
+   * @remarks
+   * If width is set, return the set value,
+   * otherwise return `SpriteMask.sprite.width`.
    */ function get() {
-                if (this._width === undefined && this._sprite) {
-                    this.width = this._sprite.width;
+                if (this._customWidth !== undefined) {
+                    return this._customWidth;
+                } else {
+                    this._dirtyUpdateFlag & 0x4 && this._calDefaultSize();
+                    return this._automaticWidth;
                 }
-                return this._width;
             },
             set: function set(value) {
-                if (this._width !== value) {
-                    this._width = value;
+                if (this._customWidth !== value) {
+                    this._customWidth = value;
                     this._dirtyUpdateFlag |= RendererUpdateFlags.WorldVolume;
                 }
             }
@@ -11240,16 +11345,22 @@ SimpleSpriteAssembler = __decorate([
         {
             key: "height",
             get: /**
-   * Render height.
+   * Render height (in world coordinates).
+   *
+   * @remarks
+   * If height is set, return the set value,
+   * otherwise return `SpriteMask.sprite.height`.
    */ function get() {
-                if (this._height === undefined && this._sprite) {
-                    this.height = this._sprite.height;
+                if (this._customHeight !== undefined) {
+                    return this._customHeight;
+                } else {
+                    this._dirtyUpdateFlag & 0x4 && this._calDefaultSize();
+                    return this._automaticHeight;
                 }
-                return this._height;
             },
             set: function set(value) {
-                if (this._height !== value) {
-                    this._height = value;
+                if (this._customHeight !== value) {
+                    this._customHeight = value;
                     this._dirtyUpdateFlag |= RendererUpdateFlags.WorldVolume;
                 }
             }
@@ -11292,10 +11403,14 @@ SimpleSpriteAssembler = __decorate([
             set: function set(value) {
                 var lastSprite = this._sprite;
                 if (lastSprite !== value) {
-                    lastSprite && lastSprite._updateFlagManager.removeListener(this._onSpriteChange);
+                    if (lastSprite) {
+                        lastSprite._addReferCount(-1);
+                        lastSprite._updateFlagManager.removeListener(this._onSpriteChange);
+                    }
+                    this._dirtyUpdateFlag |= 0x7;
                     if (value) {
+                        value._addReferCount(1);
                         value._updateFlagManager.addListener(this._onSpriteChange);
-                        this._dirtyUpdateFlag |= 0x3;
                         this.shaderData.setTexture(SpriteMask._textureProperty, value.texture);
                     } else {
                         this.shaderData.setTexture(SpriteMask._textureProperty, null);
@@ -11335,10 +11450,16 @@ __decorate([
 ], SpriteMask.prototype, "_sprite", void 0);
 __decorate([
     ignoreClone
-], SpriteMask.prototype, "_width", void 0);
+], SpriteMask.prototype, "_automaticWidth", void 0);
 __decorate([
     ignoreClone
-], SpriteMask.prototype, "_height", void 0);
+], SpriteMask.prototype, "_automaticHeight", void 0);
+__decorate([
+    assignmentClone
+], SpriteMask.prototype, "_customWidth", void 0);
+__decorate([
+    assignmentClone
+], SpriteMask.prototype, "_customHeight", void 0);
 __decorate([
     assignmentClone
 ], SpriteMask.prototype, "_flipX", void 0);
@@ -11356,7 +11477,9 @@ var /**
  */ SpriteMaskUpdateFlags;
 (function(SpriteMaskUpdateFlags) {
     SpriteMaskUpdateFlags[SpriteMaskUpdateFlags[/** UV. */ "UV"] = 0x2] = "UV";
-    SpriteMaskUpdateFlags[SpriteMaskUpdateFlags[/** All. */ "All"] = 0x3] = "All";
+    SpriteMaskUpdateFlags[SpriteMaskUpdateFlags[/** WorldVolume and UV . */ "RenderData"] = 0x3] = "RenderData";
+    SpriteMaskUpdateFlags[SpriteMaskUpdateFlags[/** Automatic Size. */ "AutomaticSize"] = 0x4] = "AutomaticSize";
+    SpriteMaskUpdateFlags[SpriteMaskUpdateFlags[/** All. */ "All"] = 0x7] = "All";
 })(SpriteMaskUpdateFlags || (SpriteMaskUpdateFlags = {}));
 
 /**
@@ -11621,7 +11744,9 @@ var BufferUtil = /*#__PURE__*/ function() {
         var platformBuffer = this._engine._hardwareRenderer.createPlatformBuffer(this._type, this._byteLength, this._bufferUsage);
         this._platformBuffer = platformBuffer;
     };
-    _proto._onDestroy = function _onDestroy() {
+    /**
+   * @internal
+   */ _proto._onDestroy = function _onDestroy() {
         GraphicsResource.prototype._onDestroy.call(this);
         this._platformBuffer.destroy();
     };
@@ -11800,10 +11925,11 @@ var BufferUtil = /*#__PURE__*/ function() {
     /**
    * @internal
    */ _proto._setVertexBufferBinding = function _setVertexBufferBinding(index, binding) {
-        if (this._getReferCount() > 0) {
-            var lastBinding = this._vertexBufferBindings[index];
-            lastBinding && lastBinding._buffer._addReferCount(-1);
-            binding._buffer._addReferCount(1);
+        var referCount = this._getReferCount();
+        if (referCount > 0) {
+            var _this__vertexBufferBindings_index;
+            (_this__vertexBufferBindings_index = this._vertexBufferBindings[index]) == null ? void 0 : _this__vertexBufferBindings_index._buffer._addReferCount(-referCount);
+            binding == null ? void 0 : binding._buffer._addReferCount(referCount);
         }
         this._vertexBufferBindings[index] = binding;
         this._bufferStructChanged = true;
@@ -11815,11 +11941,13 @@ var BufferUtil = /*#__PURE__*/ function() {
         this._bufferStructChanged = false;
     };
     _proto._addReferCount = function _addReferCount(value) {
+        var _this__indexBufferBinding;
         GraphicsResource.prototype._addReferCount.call(this, value);
         var vertexBufferBindings = this._vertexBufferBindings;
         for(var i = 0, n = vertexBufferBindings.length; i < n; i++){
             vertexBufferBindings[i]._buffer._addReferCount(value);
         }
+        (_this__indexBufferBinding = this._indexBufferBinding) == null ? void 0 : _this__indexBufferBinding._buffer._addReferCount(value);
     };
     _proto._rebuild = function _rebuild() {
         this._engine._hardwareRenderer.createPlatformPrimitive(this);
@@ -11834,14 +11962,23 @@ var BufferUtil = /*#__PURE__*/ function() {
         this._vertexElementMap = null;
         this._platformPrimitive.destroy();
     };
-    _proto._setVertexElements = function _setVertexElements(elements) {
+    /**
+   * @internal
+   */ _proto._setVertexElements = function _setVertexElements(elements) {
         this._clearVertexElements();
         for(var i = 0, n = elements.length; i < n; i++){
             this._addVertexElement(elements[i]);
         }
     };
-    _proto._setIndexBufferBinding = function _setIndexBufferBinding(binding) {
+    /**
+   * @internal
+   */ _proto._setIndexBufferBinding = function _setIndexBufferBinding(binding) {
         var lastBinding = this._indexBufferBinding;
+        var referCount = this._getReferCount();
+        if (referCount > 0) {
+            lastBinding == null ? void 0 : lastBinding.buffer._addReferCount(-referCount);
+            binding == null ? void 0 : binding.buffer._addReferCount(referCount);
+        }
         if (binding) {
             this._indexBufferBinding = binding;
             this._glIndexType = BufferUtil._getGLIndexType(binding.format);
@@ -12157,6 +12294,7 @@ var MeshModifyFlags;
         var subDataDirtyFlags = this._subDataDirtyFlags;
         var blendShapeFloatStride = this._vertexElementCount * 3;
         var blendShapeByteStride = blendShapeFloatStride * 4;
+        var bufferOffset = this._bufferBindingOffset;
         // @todo: should fix bug when dataChangedFlag is true
         for(var i = 0, n = blendShapes.length; i < n; i++){
             var dataChangedFlag = subDataDirtyFlags[i];
@@ -12174,7 +12312,7 @@ var MeshModifyFlags;
                 var offset = indexInBuffer * blendShapeFloatStride;
                 var storeInfo = storeInfos[i];
                 storeInfo || (storeInfos[i] = storeInfo = new engineMath.Vector2());
-                storeInfo.set(bufferIndex + 1, indexInBuffer * blendShapeByteStride); // BlendShape buffer is start from 1
+                storeInfo.set(bufferOffset + bufferIndex, indexInBuffer * blendShapeByteStride); // BufferOffset is mesh vertexBuffer offset
                 var deltaPositions = endFrame.deltaPositions;
                 for(var j = 0; j < vertexCount; j++){
                     var start = offset + bufferFloatStride * j;
@@ -12978,7 +13116,9 @@ var MeshModifyFlags;
         }
         this.setTangents(tangents);
     };
-    _proto._onDestroy = function _onDestroy() {
+    /**
+   * @internal
+   */ _proto._onDestroy = function _onDestroy() {
         Mesh.prototype._onDestroy.call(this);
         this._readable && this._releaseCache();
     };
@@ -13449,24 +13589,31 @@ var VertexChangedFlags;
     function MeshRenderer(entity) {
         var _this;
         _this = Renderer.call(this, entity) || this;
+        _this._enableVertexColor = false;
         _this._onMeshChanged = _this._onMeshChanged.bind(_assert_this_initialized(_this));
         return _this;
     }
     var _proto = MeshRenderer.prototype;
-    _proto._onDestroy = function _onDestroy() {
+    /**
+   * @internal
+   */ _proto._onDestroy = function _onDestroy() {
         Renderer.prototype._onDestroy.call(this);
         var mesh = this._mesh;
         if (mesh && !mesh.destroyed) {
             mesh._addReferCount(-1);
+            mesh._updateFlagManager.removeListener(this._onMeshChanged);
             this._mesh = null;
         }
     };
     /**
    * @internal
    */ _proto._cloneTo = function _cloneTo(target) {
+        Renderer.prototype._cloneTo.call(this, target);
         target.mesh = this._mesh;
     };
-    _proto._updateBounds = function _updateBounds(worldBounds) {
+    /**
+   * @internal
+   */ _proto._updateBounds = function _updateBounds(worldBounds) {
         var mesh = this._mesh;
         if (mesh) {
             var localBounds = mesh.bounds;
@@ -13477,7 +13624,9 @@ var VertexChangedFlags;
             worldBounds.max.set(0, 0, 0);
         }
     };
-    _proto._render = function _render(context) {
+    /**
+   * @internal
+   */ _proto._render = function _render(context) {
         var mesh = this._mesh;
         if (mesh) {
             if (this._dirtyUpdateFlag & 0x2) {
@@ -13487,7 +13636,7 @@ var VertexChangedFlags;
                 shaderData.disableMacro(MeshRenderer._uv1Macro);
                 shaderData.disableMacro(MeshRenderer._normalMacro);
                 shaderData.disableMacro(MeshRenderer._tangentMacro);
-                shaderData.disableMacro(MeshRenderer._vertexColorMacro);
+                shaderData.disableMacro(MeshRenderer._enableVertexColorMacro);
                 for(var i = 0, n = vertexElements.length; i < n; i++){
                     switch(vertexElements[i].semantic){
                         case "TEXCOORD_0":
@@ -13503,7 +13652,7 @@ var VertexChangedFlags;
                             shaderData.enableMacro(MeshRenderer._tangentMacro);
                             break;
                         case "COLOR_0":
-                            shaderData.enableMacro(MeshRenderer._vertexColorMacro);
+                            this._enableVertexColor && shaderData.enableMacro(MeshRenderer._enableVertexColorMacro);
                             break;
                     }
                 }
@@ -13554,6 +13703,20 @@ var VertexChangedFlags;
                     this._setMesh(value);
                 }
             }
+        },
+        {
+            key: "enableVertexColor",
+            get: /**
+   * Whether enable vertex color.
+   */ function get() {
+                return this._enableVertexColor;
+            },
+            set: function set(value) {
+                if (value !== this._enableVertexColor) {
+                    this._dirtyUpdateFlag |= 0x2;
+                    this._enableVertexColor = value;
+                }
+            }
         }
     ]);
     return MeshRenderer;
@@ -13571,7 +13734,7 @@ var VertexChangedFlags;
     MeshRenderer._tangentMacro = ShaderMacro.getByName("RENDERER_HAS_TANGENT");
 })();
 (function() {
-    MeshRenderer._vertexColorMacro = ShaderMacro.getByName("RENDERER_HAS_VERTEXCOLOR");
+    MeshRenderer._enableVertexColorMacro = ShaderMacro.getByName("RENDERER_ENABLE_VERTEXCOLOR");
 })();
 __decorate([
     ignoreClone
@@ -13603,7 +13766,7 @@ var /**
         // Limit size to 256 to avoid some problem:
         // For renderer is "Apple GPU", when uniform is large than 256 the skeleton matrix array access in shader very slow in Safari or WKWebview. This may be a apple bug, Chrome and Firefox is OK!
         // For renderer is "ANGLE (AMD, AMD Radeon(TM) Graphics Direct3011 vs_5_0 ps_5_0, D3011)", compile shader si very slow because of max uniform is 4096.
-        maxVertexUniformVectors = Math.min(maxVertexUniformVectors, 256);
+        maxVertexUniformVectors = Math.min(maxVertexUniformVectors, rhi._options._maxAllowSkinUniformVectorCount);
         _this._maxVertexUniformVectors = maxVertexUniformVectors;
         _this._onLocalBoundsChanged = _this._onLocalBoundsChanged.bind(_assert_this_initialized(_this));
         var localBounds = _this._localBounds;
@@ -13638,7 +13801,9 @@ var /**
             }
         }
     };
-    _proto._updateShaderData = function _updateShaderData(context) {
+    /**
+   * @internal
+   */ _proto._updateShaderData = function _updateShaderData(context) {
         var entity = this.entity;
         var worldMatrix = this._rootBone ? this._rootBone.transform.worldMatrix : entity.transform.worldMatrix;
         this._updateTransformShaderData(context, worldMatrix);
@@ -13664,6 +13829,7 @@ var /**
                             (_this__jointTexture = this._jointTexture) == null ? void 0 : _this__jointTexture.destroy();
                             this._jointTexture = new Texture2D(engine, 4, jointCount, exports.TextureFormat.R32G32B32A32, false);
                             this._jointTexture.filterMode = exports.TextureFilterMode.Point;
+                            this._jointTexture.isGCIgnored = true;
                         }
                         shaderData.disableMacro("RENDERER_JOINTS_NUM");
                         shaderData.enableMacro("RENDERER_USE_JOINT_TEXTURE");
@@ -13689,14 +13855,26 @@ var /**
     };
     /**
    * @internal
+   */ _proto._onDestroy = function _onDestroy() {
+        var _this_rootBone, _this__jointTexture;
+        MeshRenderer.prototype._onDestroy.call(this);
+        (_this_rootBone = this.rootBone) == null ? void 0 : _this_rootBone.transform._updateFlagManager.removeListener(this._onTransformChanged);
+        (_this__jointTexture = this._jointTexture) == null ? void 0 : _this__jointTexture.destroy();
+    };
+    /**
+   * @internal
    */ _proto._cloneTo = function _cloneTo(target) {
         MeshRenderer.prototype._cloneTo.call(this, target);
         this._blendShapeWeights && (target._blendShapeWeights = this._blendShapeWeights.slice());
     };
-    _proto._registerEntityTransformListener = function _registerEntityTransformListener() {
+    /**
+   * @internal
+   */ _proto._registerEntityTransformListener = function _registerEntityTransformListener() {
     // Cancel register listener to entity transform.
     };
-    _proto._updateBounds = function _updateBounds(worldBounds) {
+    /**
+   * @internal
+   */ _proto._updateBounds = function _updateBounds(worldBounds) {
         if (this._rootBone) {
             var localBounds = this._localBounds;
             var worldMatrix = this._rootBone.transform.worldMatrix;
@@ -15149,14 +15327,17 @@ var Basic2DBatcher = /*#__PURE__*/ function() {
     _proto._createMesh = function _createMesh(engine, index) {
         var MAX_VERTEX_COUNT = Basic2DBatcher.MAX_VERTEX_COUNT;
         var mesh = new BufferMesh(engine, "BufferMesh" + index);
+        mesh.isGCIgnored = true;
         var vertexElements = [];
         var vertexStride = this.createVertexElements(vertexElements);
         // vertices
-        this._vertexBuffers[index] = new Buffer(engine, exports.BufferBindFlag.VertexBuffer, MAX_VERTEX_COUNT * 4 * vertexStride, exports.BufferUsage.Dynamic);
+        var vertexBuffer = this._vertexBuffers[index] = new Buffer(engine, exports.BufferBindFlag.VertexBuffer, MAX_VERTEX_COUNT * 4 * vertexStride, exports.BufferUsage.Dynamic);
+        vertexBuffer.isGCIgnored = true;
         // indices
-        this._indiceBuffers[index] = new Buffer(engine, exports.BufferBindFlag.IndexBuffer, MAX_VERTEX_COUNT * 3, exports.BufferUsage.Dynamic);
-        mesh.setVertexBufferBinding(this._vertexBuffers[index], vertexStride);
-        mesh.setIndexBufferBinding(this._indiceBuffers[index], exports.IndexFormat.UInt16);
+        var indiceBuffer = this._indiceBuffers[index] = new Buffer(engine, exports.BufferBindFlag.IndexBuffer, MAX_VERTEX_COUNT * 2 * 3, exports.BufferUsage.Dynamic);
+        indiceBuffer.isGCIgnored = true;
+        mesh.setVertexBufferBinding(vertexBuffer, vertexStride);
+        mesh.setIndexBufferBinding(indiceBuffer, exports.IndexFormat.UInt16);
         mesh.setVertexElements(vertexElements);
         return mesh;
     };
@@ -15440,6 +15621,12 @@ var TextRenderData = /*#__PURE__*/ function(RenderData) {
     var _proto = Sky.prototype;
     /**
    * @internal
+   */ _proto.destroy = function destroy() {
+        this.mesh = null;
+        this.material = null;
+    };
+    /**
+   * @internal
    */ _proto._render = function _render(context) {
         var _this = this, material = _this.material, mesh = _this.mesh;
         if (!material) {
@@ -15480,6 +15667,40 @@ var TextRenderData = /*#__PURE__*/ function(RenderData) {
         rhi.drawPrimitive(mesh, mesh.subMesh, program);
         cameraShaderData.setMatrix(RenderContext.vpMatrixProperty, originViewProjMatrix);
     };
+    _create_class(Sky, [
+        {
+            key: "material",
+            get: /**
+   *  Material of the sky.
+   */ function get() {
+                return this._material;
+            },
+            set: function set(value) {
+                if (this._material !== value) {
+                    var _this__material;
+                    value == null ? void 0 : value._addReferCount(1);
+                    (_this__material = this._material) == null ? void 0 : _this__material._addReferCount(-1);
+                    this._material = value;
+                }
+            }
+        },
+        {
+            key: "mesh",
+            get: /**
+   *  Mesh of the sky.
+   */ function get() {
+                return this._mesh;
+            },
+            set: function set(value) {
+                if (this._mesh !== value) {
+                    var _this__mesh;
+                    value == null ? void 0 : value._addReferCount(1);
+                    (_this__mesh = this._mesh) == null ? void 0 : _this__mesh._addReferCount(-1);
+                    this._mesh = value;
+                }
+            }
+        }
+    ]);
     return Sky;
 }();
 (function() {
@@ -15515,9 +15736,19 @@ var TextRenderData = /*#__PURE__*/ function(RenderData) {
     var _proto = Background.prototype;
     /**
    * @internal
+   */ _proto.destroy = function destroy() {
+        this._mesh._addReferCount(-1);
+        this._mesh = null;
+        this.texture = null;
+        this.solidColor = null;
+        this.sky.destroy();
+    };
+    /**
+   * @internal
    * Standalone for CanvasRenderer plugin.
    */ _proto._initMesh = function _initMesh(engine) {
         this._mesh = this._createPlane(engine);
+        this._mesh._addReferCount(1);
     };
     /**
    * @internal
@@ -15589,6 +15820,9 @@ var TextRenderData = /*#__PURE__*/ function(RenderData) {
             },
             set: function set(value) {
                 if (this._texture !== value) {
+                    var _this__texture;
+                    value == null ? void 0 : value._addReferCount(1);
+                    (_this__texture = this._texture) == null ? void 0 : _this__texture._addReferCount(-1);
                     this._texture = value;
                     this._engine._backgroundTextureMaterial.shaderData.setTexture("material_BaseTexture", value);
                 }
@@ -16066,7 +16300,7 @@ var TextRenderData = /*#__PURE__*/ function(RenderData) {
         var sunLightIndex = lightManager._getSunLightIndex();
         if (sunLightIndex !== -1) {
             var sunlight = lightManager._directLights.get(sunLightIndex);
-            shaderData.setColor(Scene._sunlightColorProperty, sunlight.color);
+            shaderData.setColor(Scene._sunlightColorProperty, sunlight._getLightIntensityColor());
             shaderData.setVector3(Scene._sunlightDirectionProperty, sunlight.direction);
             this._sunLight = sunlight;
         }
@@ -16097,6 +16331,7 @@ var TextRenderData = /*#__PURE__*/ function(RenderData) {
             this._rootEntities[0].destroy();
         }
         this._activeCameras.length = 0;
+        this.background.destroy();
         this.shaderData._addReferCount(-1);
     };
     _proto._addToRootEntityList = function _addToRootEntityList(index, rootEntity) {
@@ -16554,7 +16789,7 @@ ShaderPool.init();
         _this._spriteDefaultMaterial = _this._createSpriteMaterial();
         _this._spriteMaskDefaultMaterial = _this._createSpriteMaskMaterial();
         _this._textDefaultFont = Font.createFromOS(_assert_this_initialized(_this), "Arial");
-        _this._textDefaultFont.isGCIgnored = false;
+        _this._textDefaultFont.isGCIgnored = true;
         _this.inputManager = new InputManager(_assert_this_initialized(_this));
         _this._initMagentaTextures(hardwareRenderer);
         if (!hardwareRenderer.canIUse(exports.GLCapabilityType.depthTexture)) {
@@ -16565,6 +16800,7 @@ ShaderPool.init();
             _this._depthTexture2D = depthTexture2D;
         }
         var magentaMaterial = new Material(_assert_this_initialized(_this), Shader.find("unlit"));
+        magentaMaterial.isGCIgnored = true;
         magentaMaterial.shaderData.setColor("material_BaseColor", new Color(1.0, 0.0, 1.01, 1.0));
         _this._magentaMaterial = magentaMaterial;
         var backgroundTextureMaterial = new Material(_assert_this_initialized(_this), Shader.find("background-texture"));
@@ -16791,7 +17027,9 @@ ShaderPool.init();
             this._magentaTexture2DArray = magentaTexture2DArray;
         }
     };
-    _proto._initialize = function _initialize(configuration) {
+    /**
+   * @internal
+   */ _proto._initialize = function _initialize(configuration) {
         var _this = this;
         var physics = configuration.physics;
         if (physics) {
@@ -17113,7 +17351,9 @@ ShaderPool.init();
         this._entity._removeScript(this);
         this._waitHandlingInValid = false;
     };
-    _proto._onDestroy = function _onDestroy() {
+    /**
+   * @internal
+   */ _proto._onDestroy = function _onDestroy() {
         Component.prototype._onDestroy.call(this);
         this._engine._componentsManager.addPendingDestroyScript(this);
     };
@@ -18063,7 +18303,7 @@ var /**
             // prepare render target
             var renderTarget = this._getAvailableRenderTarget();
             // @todo: shouldn't set viewport and scissor in activeRenderTarget
-            rhi.activeRenderTarget(renderTarget, null, 0);
+            rhi.activeRenderTarget(renderTarget, CascadedShadowCasterPass._viewport, 0);
             if (this._supportDepthTexture) {
                 rhi.clearRenderTarget(engine, exports.CameraClearFlags.Depth, null);
             } else {
@@ -18185,11 +18425,13 @@ var /**
             if (engine._hardwareRenderer._isWebGL2) {
                 depthTexture.depthCompareFunction = exports.TextureDepthCompareFunction.Less;
             }
+            renderTarget == null ? void 0 : renderTarget._addReferCount(-1);
             if (this._supportDepthTexture) {
                 renderTarget = this._renderTargets = new RenderTarget(engine, width, height, null, depthTexture);
             } else {
                 renderTarget = this._renderTargets = new RenderTarget(engine, width, height, depthTexture);
             }
+            renderTarget._addReferCount(1);
         }
         return renderTarget;
     };
@@ -18212,7 +18454,12 @@ var /**
                 var height = shadowCascades == exports.ShadowCascadesMode.TwoCascades ? shadowTileResolution : shadowTileResolution * 2;
                 this._shadowMapSize.set(1.0 / width, 1.0 / height, width, height);
             }
-            this._renderTargets = null;
+            var renderTargets = this._renderTargets;
+            if (renderTargets) {
+                renderTargets._addReferCount(-1);
+                renderTargets.destroy();
+                this._renderTargets = null;
+            }
             var viewportOffset = this._viewportOffsets;
             var shadowTileResolution1 = this._shadowTileResolution;
             switch(shadowCascades){
@@ -18268,6 +18515,9 @@ var /**
 (function() {
     CascadedShadowCasterPass._cascadesSplitDistance = new Array(CascadedShadowCasterPass._maxCascades + 1);
 })();
+(function() {
+    CascadedShadowCasterPass._viewport = new engineMath.Vector4(0, 0, 1, 1);
+})();
 (function() {
     CascadedShadowCasterPass._clearColor = new engineMath.Color(1, 1, 1, 1);
 })();
@@ -18796,6 +19046,7 @@ exports.Camera = (_Camera = /*#__PURE__*/ function(Component) {
         this.entity.scene._detachRenderCamera(this);
     };
     /**
+   * @internal
    * @inheritdoc
    */ _proto._onDestroy = function _onDestroy() {
         var _this__renderPipeline;
@@ -19001,7 +19252,12 @@ exports.Camera = (_Camera = /*#__PURE__*/ function(Component) {
                 return this._renderTarget;
             },
             set: function set(value) {
-                this._renderTarget = value;
+                if (this._renderTarget !== value) {
+                    var _this__renderTarget;
+                    value == null ? void 0 : value._addReferCount(1);
+                    (_this__renderTarget = this._renderTarget) == null ? void 0 : _this__renderTarget._addReferCount(-1);
+                    this._renderTarget = value;
+                }
             }
         }
     ]);
@@ -19990,6 +20246,7 @@ var BaseMaterial = /*#__PURE__*/ function(Material) {
         _this = PBRBaseMaterial.call(this, engine, Shader.find("pbr")) || this;
         _this.shaderData.setFloat(PBRMaterial._metallicProp, 1);
         _this.shaderData.setFloat(PBRMaterial._roughnessProp, 1);
+        _this.shaderData.setFloat(PBRMaterial._iorProp, 1.5);
         return _this;
     }
     var _proto = PBRMaterial.prototype;
@@ -20001,10 +20258,23 @@ var BaseMaterial = /*#__PURE__*/ function(Material) {
         return dest;
     };
     _create_class(PBRMaterial, [
+        {
+            key: "ior",
+            get: /**
+   * Index Of Refraction.
+   * @defaultValue `1.5`
+   */ function get() {
+                return this.shaderData.getFloat(PBRMaterial._iorProp);
+            },
+            set: function set(v) {
+                this.shaderData.setFloat(PBRMaterial._iorProp, Math.max(v, 0));
+            }
+        },
         {
             key: "metallic",
             get: /**
-   * Metallic, default 1.0.
+   * Metallic.
+   * @defaultValue `1.0`
    */ function get() {
                 return this.shaderData.getFloat(PBRMaterial._metallicProp);
             },
@@ -20015,7 +20285,8 @@ var BaseMaterial = /*#__PURE__*/ function(Material) {
         {
             key: "roughness",
             get: /**
-   * Roughness, default 1.0.
+   * Roughness. default 1.0.
+   * @defaultValue `1.0`
    */ function get() {
                 return this.shaderData.getFloat(PBRMaterial._roughnessProp);
             },
@@ -20052,6 +20323,9 @@ var BaseMaterial = /*#__PURE__*/ function(Material) {
 (function() {
     PBRMaterial._roughnessMetallicTextureProp = ShaderProperty.getByName("material_RoughnessMetallicTexture");
 })();
+(function() {
+    PBRMaterial._iorProp = Shader.getPropertyByName("material_IOR");
+})();
 
 /**
  * PBR (Specular-Glossiness Workflow) Material.
@@ -20263,9 +20537,18 @@ exports.TextVerticalAlignment = void 0;
    * @internal
    */ _proto._addSprite = function _addSprite(sprite) {
         this._spriteNamesToIndex[sprite.name] = this._sprites.push(sprite) - 1;
+        sprite._atlas = this;
+        sprite.isGCIgnored = true;
     };
-    _proto._onDestroy = function _onDestroy() {
+    /**
+   * @internal
+   */ _proto._onDestroy = function _onDestroy() {
         ReferResource.prototype._onDestroy.call(this);
+        var _this = this, sprites = _this._sprites;
+        for(var i = 0, n = sprites.length; i < n; i++){
+            sprites[i].destroy();
+        }
+        sprites.length = 0;
         this._sprites = null;
         this._spriteNamesToIndex = null;
     };
@@ -20313,8 +20596,10 @@ exports.TextVerticalAlignment = void 0;
         if (name === void 0) name = null;
         var _this;
         _this = ReferResource.call(this, engine) || this;
-        _this._width = undefined;
-        _this._height = undefined;
+        _this._automaticWidth = 0;
+        _this._automaticHeight = 0;
+        _this._customWidth = undefined;
+        _this._customHeight = undefined;
         _this._positions = [
             new engineMath.Vector2(),
             new engineMath.Vector2(),
@@ -20335,7 +20620,7 @@ exports.TextVerticalAlignment = void 0;
         _this._region = new engineMath.Rect(0, 0, 1, 1);
         _this._pivot = new engineMath.Vector2(0.5, 0.5);
         _this._border = new engineMath.Vector4(0, 0, 0, 0);
-        _this._dirtyUpdateFlag = 0x3;
+        _this._dirtyUpdateFlag = 0x7;
         /** @internal */ _this._updateFlagManager = new UpdateFlagManager();
         _this._texture = texture;
         region && _this._region.copyFrom(region);
@@ -20373,17 +20658,41 @@ exports.TextVerticalAlignment = void 0;
         this._dirtyUpdateFlag & 0x1 && this._updatePositions();
         return this._bounds;
     };
-    _proto._onDestroy = function _onDestroy() {
+    /**
+   * @internal
+   */ _proto._addReferCount = function _addReferCount(value) {
+        var _this__atlas;
+        ReferResource.prototype._addReferCount.call(this, value);
+        (_this__atlas = this._atlas) == null ? void 0 : _this__atlas._addReferCount(value);
+    };
+    /**
+   * @internal
+   */ _proto._onDestroy = function _onDestroy() {
         ReferResource.prototype._onDestroy.call(this);
+        this._positions.length = 0;
+        this._positions = null;
+        this._uvs.length = 0;
+        this._uvs = null;
+        this._atlasRegion = null;
+        this._atlasRegionOffset = null;
+        this._region = null;
+        this._pivot = null;
+        this._border = null;
+        this._bounds = null;
+        this._atlas = null;
         this._texture = null;
+        this._updateFlagManager = null;
     };
     _proto._calDefaultSize = function _calDefaultSize() {
         if (this._texture) {
             var _this = this, _texture = _this._texture, _atlasRegion = _this._atlasRegion, _atlasRegionOffset = _this._atlasRegionOffset, _region = _this._region;
             var pixelsPerUnitReciprocal = 1.0 / Engine._pixelsPerUnit;
-            this._width = _texture.width * _atlasRegion.width / (1 - _atlasRegionOffset.x - _atlasRegionOffset.z) * _region.width * pixelsPerUnitReciprocal;
-            this._height = _texture.height * _atlasRegion.height / (1 - _atlasRegionOffset.y - _atlasRegionOffset.w) * _region.height * pixelsPerUnitReciprocal;
+            this._automaticWidth = _texture.width * _atlasRegion.width / (1 - _atlasRegionOffset.x - _atlasRegionOffset.z) * _region.width * pixelsPerUnitReciprocal;
+            this._automaticHeight = _texture.height * _atlasRegion.height / (1 - _atlasRegionOffset.y - _atlasRegionOffset.w) * _region.height * pixelsPerUnitReciprocal;
+        } else {
+            this._automaticWidth = this._automaticHeight = 0;
         }
+        this._dirtyUpdateFlag &= ~0x4;
     };
     _proto._updatePositions = function _updatePositions() {
         var blank = this._atlasRegionOffset;
@@ -20437,11 +20746,16 @@ exports.TextVerticalAlignment = void 0;
     };
     _proto._dispatchSpriteChange = function _dispatchSpriteChange(type) {
         switch(type){
+            case SpriteModifyFlags.texture:
+                this._dirtyUpdateFlag |= 0x4;
+                break;
             case SpriteModifyFlags.atlasRegionOffset:
             case SpriteModifyFlags.region:
-                this._dirtyUpdateFlag |= 0x3;
+                this._dirtyUpdateFlag |= 0x7;
                 break;
             case SpriteModifyFlags.atlasRegion:
+                this._dirtyUpdateFlag |= 0x4 | 0x2;
+                break;
             case SpriteModifyFlags.border:
                 this._dirtyUpdateFlag |= 0x2;
                 break;
@@ -20460,7 +20774,9 @@ exports.TextVerticalAlignment = void 0;
                 if (this._texture !== value) {
                     this._texture = value;
                     this._dispatchSpriteChange(SpriteModifyFlags.texture);
-                    (this._width === undefined || this._height === undefined) && this._dispatchSpriteChange(SpriteModifyFlags.size);
+                    if (this._customWidth === undefined || this._customHeight === undefined) {
+                        this._dispatchSpriteChange(SpriteModifyFlags.size);
+                    }
                 }
             }
         },
@@ -20468,13 +20784,21 @@ exports.TextVerticalAlignment = void 0;
             key: "width",
             get: /**
    * The width of the sprite (in world coordinates).
+   *
+   * @remarks
+   * If width is set, return the set value,
+   * otherwise return the width calculated according to `Texture.width`, `Sprite.region`, `Sprite.atlasRegion`, `Sprite.atlasRegionOffset` and `Engine._pixelsPerUnit`.
    */ function get() {
-                this._width === undefined && this._calDefaultSize();
-                return this._width;
+                if (this._customWidth !== undefined) {
+                    return this._customWidth;
+                } else {
+                    this._dirtyUpdateFlag & 0x4 && this._calDefaultSize();
+                    return this._automaticWidth;
+                }
             },
             set: function set(value) {
-                if (this._width !== value) {
-                    this._width = value;
+                if (this._customWidth !== value) {
+                    this._customWidth = value;
                     this._dispatchSpriteChange(SpriteModifyFlags.size);
                 }
             }
@@ -20483,13 +20807,21 @@ exports.TextVerticalAlignment = void 0;
             key: "height",
             get: /**
    * The height of the sprite (in world coordinates).
+   *
+   * @remarks
+   * If height is set, return the set value,
+   * otherwise return the height calculated according to `Texture.height`, `Sprite.region`, `Sprite.atlasRegion`, `Sprite.atlasRegionOffset` and `Engine._pixelsPerUnit`.
    */ function get() {
-                this._height === undefined && this._calDefaultSize();
-                return this._height;
+                if (this._customHeight !== undefined) {
+                    return this._customHeight;
+                } else {
+                    this._dirtyUpdateFlag & 0x4 && this._calDefaultSize();
+                    return this._automaticHeight;
+                }
             },
             set: function set(value) {
-                if (this._height !== value) {
-                    this._height = value;
+                if (this._customHeight !== value) {
+                    this._customHeight = value;
                     this._dispatchSpriteChange(SpriteModifyFlags.size);
                 }
             }
@@ -20519,7 +20851,9 @@ exports.TextVerticalAlignment = void 0;
                 var y = engineMath.MathUtil.clamp(value.y, 0, 1);
                 this._atlasRegion.set(x, y, engineMath.MathUtil.clamp(value.width, 0, 1 - x), engineMath.MathUtil.clamp(value.height, 0, 1 - y));
                 this._dispatchSpriteChange(SpriteModifyFlags.atlasRegion);
-                (this._width === undefined || this._height === undefined) && this._dispatchSpriteChange(SpriteModifyFlags.size);
+                if (this._customWidth === undefined || this._customHeight === undefined) {
+                    this._dispatchSpriteChange(SpriteModifyFlags.size);
+                }
             }
         },
         {
@@ -20534,7 +20868,9 @@ exports.TextVerticalAlignment = void 0;
                 var y = engineMath.MathUtil.clamp(value.y, 0, 1);
                 this._atlasRegionOffset.set(x, y, engineMath.MathUtil.clamp(value.z, 0, 1 - x), engineMath.MathUtil.clamp(value.w, 0, 1 - y));
                 this._dispatchSpriteChange(SpriteModifyFlags.atlasRegionOffset);
-                (this._width === undefined || this._height === undefined) && this._dispatchSpriteChange(SpriteModifyFlags.size);
+                if (this._customWidth === undefined || this._customHeight === undefined) {
+                    this._dispatchSpriteChange(SpriteModifyFlags.size);
+                }
             }
         },
         {
@@ -20550,7 +20886,9 @@ exports.TextVerticalAlignment = void 0;
                 var y = engineMath.MathUtil.clamp(value.y, 0, 1);
                 region.set(x, y, engineMath.MathUtil.clamp(value.width, 0, 1 - x), engineMath.MathUtil.clamp(value.height, 0, 1 - y));
                 this._dispatchSpriteChange(SpriteModifyFlags.region);
-                (this._width === undefined || this._height === undefined) && this._dispatchSpriteChange(SpriteModifyFlags.size);
+                if (this._customWidth === undefined || this._customHeight === undefined) {
+                    this._dispatchSpriteChange(SpriteModifyFlags.size);
+                }
             }
         },
         {
@@ -20600,7 +20938,8 @@ var SpriteUpdateFlags;
 (function(SpriteUpdateFlags) {
     SpriteUpdateFlags[SpriteUpdateFlags["positions"] = 0x1] = "positions";
     SpriteUpdateFlags[SpriteUpdateFlags["uvs"] = 0x2] = "uvs";
-    SpriteUpdateFlags[SpriteUpdateFlags["all"] = 0x3] = "all";
+    SpriteUpdateFlags[SpriteUpdateFlags["automaticSize"] = 0x4] = "automaticSize";
+    SpriteUpdateFlags[SpriteUpdateFlags["all"] = 0x7] = "all";
 })(SpriteUpdateFlags || (SpriteUpdateFlags = {}));
 
 var _SlicedSpriteAssembler;
@@ -21092,8 +21431,10 @@ var TiledType;
         _this._tiledAdaptiveThreshold = 0.5;
         _this._color = new engineMath.Color(1, 1, 1, 1);
         _this._sprite = null;
-        _this._width = undefined;
-        _this._height = undefined;
+        _this._automaticWidth = 0;
+        _this._automaticHeight = 0;
+        _this._customWidth = undefined;
+        _this._customHeight = undefined;
         _this._flipX = false;
         _this._flipY = false;
         _this._maskLayer = exports.SpriteMaskLayer.Layer0;
@@ -21108,38 +21449,45 @@ var TiledType;
     /**
    * @internal
    */ _proto._cloneTo = function _cloneTo(target) {
+        Renderer.prototype._cloneTo.call(this, target);
         target._assembler.resetData(target);
         target.sprite = this._sprite;
+        target.drawMode = this._drawMode;
     };
-    _proto._updateShaderData = function _updateShaderData(context) {
+    /**
+   * @internal
+   */ _proto._updateShaderData = function _updateShaderData(context) {
         // @ts-ignore
         this._updateTransformShaderData(context, engineMath.Matrix._identity);
     };
-    _proto._updateBounds = function _updateBounds(worldBounds) {
-        var _this_sprite;
-        if (!((_this_sprite = this.sprite) == null ? void 0 : _this_sprite.texture) || !this.width || !this.height) {
+    /**
+   * @internal
+   */ _proto._updateBounds = function _updateBounds(worldBounds) {
+        if (this.sprite) {
+            this._assembler.updatePositions(this);
+        } else {
             worldBounds.min.set(0, 0, 0);
             worldBounds.max.set(0, 0, 0);
-        } else {
-            this._assembler.updatePositions(this);
         }
     };
-    _proto._render = function _render(context) {
+    /**
+   * @internal
+   */ _proto._render = function _render(context) {
         var _this_sprite;
         if (!((_this_sprite = this.sprite) == null ? void 0 : _this_sprite.texture) || !this.width || !this.height) {
             return;
         }
-        // Update position.
+        // Update position
         if (this._dirtyUpdateFlag & RendererUpdateFlags.WorldVolume) {
             this._assembler.updatePositions(this);
             this._dirtyUpdateFlag &= ~RendererUpdateFlags.WorldVolume;
         }
-        // Update uv.
+        // Update uv
         if (this._dirtyUpdateFlag & 0x2) {
             this._assembler.updateUVs(this);
             this._dirtyUpdateFlag &= ~0x2;
         }
-        // Push render data
+        // Push primitive
         var material = this.getMaterial();
         var texture = this.sprite.texture;
         var renderData = this._engine._spriteRenderDataPool.getFromPool();
@@ -21149,14 +21497,27 @@ var TiledType;
     /**
    * @internal
    */ _proto._onDestroy = function _onDestroy() {
-        var _this__sprite;
         Renderer.prototype._onDestroy.call(this);
-        (_this__sprite = this._sprite) == null ? void 0 : _this__sprite._updateFlagManager.removeListener(this._onSpriteChange);
+        var sprite = this._sprite;
+        if (sprite) {
+            sprite._addReferCount(-1);
+            sprite._updateFlagManager.removeListener(this._onSpriteChange);
+        }
         this._color = null;
         this._sprite = null;
         this._assembler = null;
         this._verticesData = null;
     };
+    _proto._calDefaultSize = function _calDefaultSize() {
+        var sprite = this._sprite;
+        if (sprite) {
+            this._automaticWidth = sprite.width;
+            this._automaticHeight = sprite.height;
+        } else {
+            this._automaticWidth = this._automaticHeight = 0;
+        }
+        this._dirtyUpdateFlag &= ~0x4;
+    };
     _proto._updateStencilState = function _updateStencilState() {
         // Update stencil.
         var material = this.getInstanceMaterial();
@@ -21183,22 +21544,21 @@ var TiledType;
                 break;
             case SpriteModifyFlags.size:
                 var _this = this, drawMode = _this._drawMode;
-                if (drawMode === exports.SpriteDrawMode.Sliced) {
+                this._dirtyUpdateFlag |= 0x4;
+                if (this._drawMode === exports.SpriteDrawMode.Sliced) {
                     this._dirtyUpdateFlag |= RendererUpdateFlags.WorldVolume;
                 } else if (drawMode === exports.SpriteDrawMode.Tiled) {
                     this._dirtyUpdateFlag |= 0x3;
                 } else {
                     // When the width and height of `SpriteRenderer` are `undefined`,
                     // the `size` of `Sprite` will affect the position of `SpriteRenderer`.
-                    if (this._width === undefined || this._height === undefined) {
+                    if (this._customWidth === undefined || this._customHeight === undefined) {
                         this._dirtyUpdateFlag |= RendererUpdateFlags.WorldVolume;
                     }
                 }
                 break;
             case SpriteModifyFlags.border:
-                if (this._drawMode === exports.SpriteDrawMode.Sliced || this._drawMode === exports.SpriteDrawMode.Tiled) {
-                    this._dirtyUpdateFlag |= 0x3;
-                }
+                this._drawMode === exports.SpriteDrawMode.Sliced && (this._dirtyUpdateFlag |= 0x3);
                 break;
             case SpriteModifyFlags.region:
             case SpriteModifyFlags.atlasRegionOffset:
@@ -21282,10 +21642,14 @@ var TiledType;
             set: function set(value) {
                 var lastSprite = this._sprite;
                 if (lastSprite !== value) {
-                    lastSprite && lastSprite._updateFlagManager.removeListener(this._onSpriteChange);
+                    if (lastSprite) {
+                        lastSprite._addReferCount(-1);
+                        lastSprite._updateFlagManager.removeListener(this._onSpriteChange);
+                    }
+                    this._dirtyUpdateFlag |= 0x7;
                     if (value) {
+                        value._addReferCount(1);
                         value._updateFlagManager.addListener(this._onSpriteChange);
-                        this._dirtyUpdateFlag |= 0x3;
                         this.shaderData.setTexture(SpriteRenderer._textureProperty, value.texture);
                     } else {
                         this.shaderData.setTexture(SpriteRenderer._textureProperty, null);
@@ -21310,16 +21674,22 @@ var TiledType;
         {
             key: "width",
             get: /**
-   * Render width.
+   * Render width (in world coordinates).
+   *
+   * @remarks
+   * If width is set, return the set value,
+   * otherwise return `SpriteRenderer.sprite.width`.
    */ function get() {
-                this._width === undefined && this._sprite && (this.width = this._sprite.width);
-                return this._width;
+                if (this._customWidth !== undefined) {
+                    return this._customWidth;
+                } else {
+                    this._dirtyUpdateFlag & 0x4 && this._calDefaultSize();
+                    return this._automaticWidth;
+                }
             },
             set: function set(value) {
-                // Update width if undefined
-                this._width === undefined && this._sprite && (this._width = this._sprite.width);
-                if (this._width !== value) {
-                    this._width = value;
+                if (this._customWidth !== value) {
+                    this._customWidth = value;
                     this._dirtyUpdateFlag |= RendererUpdateFlags.WorldVolume;
                 }
             }
@@ -21327,16 +21697,22 @@ var TiledType;
         {
             key: "height",
             get: /**
-   * Render height.
+   * Render height (in world coordinates).
+   *
+   * @remarks
+   * If height is set, return the set value,
+   * otherwise return `SpriteRenderer.sprite.height`.
    */ function get() {
-                this._height === undefined && this._sprite && (this.height = this._sprite.height);
-                return this._height;
+                if (this._customHeight !== undefined) {
+                    return this._customHeight;
+                } else {
+                    this._dirtyUpdateFlag & 0x4 && this._calDefaultSize();
+                    return this._automaticHeight;
+                }
             },
             set: function set(value) {
-                // Update height if undefined
-                this._height === undefined && this._sprite && (this._height = this._sprite.height);
-                if (this._height !== value) {
-                    this._height = value;
+                if (this._customHeight !== value) {
+                    this._customHeight = value;
                     this._dirtyUpdateFlag |= RendererUpdateFlags.WorldVolume;
                 }
             }
@@ -21423,10 +21799,16 @@ __decorate([
 ], SpriteRenderer.prototype, "_sprite", void 0);
 __decorate([
     ignoreClone
-], SpriteRenderer.prototype, "_width", void 0);
+], SpriteRenderer.prototype, "_automaticWidth", void 0);
 __decorate([
     ignoreClone
-], SpriteRenderer.prototype, "_height", void 0);
+], SpriteRenderer.prototype, "_automaticHeight", void 0);
+__decorate([
+    assignmentClone
+], SpriteRenderer.prototype, "_customWidth", void 0);
+__decorate([
+    assignmentClone
+], SpriteRenderer.prototype, "_customHeight", void 0);
 __decorate([
     assignmentClone
 ], SpriteRenderer.prototype, "_flipX", void 0);
@@ -21447,7 +21829,9 @@ var /**
  */ SpriteRendererUpdateFlags;
 (function(SpriteRendererUpdateFlags) {
     SpriteRendererUpdateFlags[SpriteRendererUpdateFlags[/** UV. */ "UV"] = 0x2] = "UV";
-    SpriteRendererUpdateFlags[SpriteRendererUpdateFlags[/** All. */ "All"] = 0x3] = "All";
+    SpriteRendererUpdateFlags[SpriteRendererUpdateFlags[/** WorldVolume and UV . */ "RenderData"] = 0x3] = "RenderData";
+    SpriteRendererUpdateFlags[SpriteRendererUpdateFlags[/** Automatic Size. */ "AutomaticSize"] = 0x4] = "AutomaticSize";
+    SpriteRendererUpdateFlags[SpriteRendererUpdateFlags[/** All. */ "All"] = 0x7] = "All";
 })(SpriteRendererUpdateFlags || (SpriteRendererUpdateFlags = {}));
 
 /**
@@ -21535,7 +21919,9 @@ var /**
         this._font._addReferCount(1);
         this.setMaterial(engine._spriteDefaultMaterial);
     };
-    _proto._onDestroy = function _onDestroy() {
+    /**
+   * @internal
+   */ _proto._onDestroy = function _onDestroy() {
         Renderer.prototype._onDestroy.call(this);
         // Clear render data.
         var charRenderDatas = this._charRenderDatas;
@@ -21552,6 +21938,7 @@ var /**
     /**
    * @internal
    */ _proto._cloneTo = function _cloneTo(target) {
+        Renderer.prototype._cloneTo.call(this, target);
         target.font = this._font;
         target._subFont = this._subFont;
     };
@@ -21570,14 +21957,20 @@ var /**
    */ _proto._setDirtyFlagFalse = function _setDirtyFlagFalse(type) {
         this._dirtyFlag &= ~type;
     };
-    _proto._updateShaderData = function _updateShaderData(context) {
+    /**
+   * @internal
+   */ _proto._updateShaderData = function _updateShaderData(context) {
         // @ts-ignore
         this._updateTransformShaderData(context, engineMath.Matrix._identity);
     };
-    _proto._updateBounds = function _updateBounds(worldBounds) {
+    /**
+   * @internal
+   */ _proto._updateBounds = function _updateBounds(worldBounds) {
         engineMath.BoundingBox.transform(this._localBounds, this._entity.transform.worldMatrix, worldBounds);
     };
-    _proto._render = function _render(context) {
+    /**
+   * @internal
+   */ _proto._render = function _render(context) {
         if (this._text === "" || this.enableWrapping && this.width <= 0 || this.overflowMode === exports.OverflowMode.Truncate && this.height <= 0) {
             return;
         }
@@ -21672,8 +22065,6 @@ var /**
     _proto._updateLocalData = function _updateLocalData() {
         var _this = this, color = _this.color, horizontalAlignment = _this.horizontalAlignment, verticalAlignment = _this.verticalAlignment, charRenderDatas = _this._charRenderDatas;
         var _this__localBounds = this._localBounds, min = _this__localBounds.min, max = _this__localBounds.max;
-        min.set(0, 0, 0);
-        max.set(0, 0, 0);
         var _pixelsPerUnit = Engine._pixelsPerUnit;
         var pixelsPerUnitReciprocal = 1.0 / _pixelsPerUnit;
         var charFont = this._subFont;
@@ -21700,54 +22091,65 @@ var /**
                 break;
         }
         var renderDataCount = 0;
+        var firstLine = -1;
         var minX = Number.MAX_SAFE_INTEGER;
         var minY = Number.MAX_SAFE_INTEGER;
         var maxX = Number.MIN_SAFE_INTEGER;
         var maxY = Number.MIN_SAFE_INTEGER;
-        var lastLineIndex = linesLen - 1;
         for(var i = 0; i < linesLen; ++i){
-            var line = lines[i];
             var lineWidth = lineWidths[i];
-            var startX = 0;
-            switch(horizontalAlignment){
-                case exports.TextHorizontalAlignment.Left:
-                    startX = -halfRendererWidth;
-                    break;
-                case exports.TextHorizontalAlignment.Center:
-                    startX = -lineWidth * 0.5;
-                    break;
-                case exports.TextHorizontalAlignment.Right:
-                    startX = halfRendererWidth - lineWidth;
-                    break;
-            }
-            for(var j = 0, m = line.length - 1; j <= m; ++j){
-                var char = line[j];
-                var charInfo = charFont._getCharInfo(char);
-                if (charInfo.h > 0) {
-                    var charRenderData = charRenderDatas[renderDataCount] || charRenderDataPool.get();
-                    var renderData = charRenderData.renderData, localPositions = charRenderData.localPositions;
-                    charRenderData.texture = charFont._getTextureByIndex(charInfo.index);
-                    renderData.color = color;
-                    renderData.uvs = charInfo.uvs;
-                    var w = charInfo.w, ascent = charInfo.ascent, descent = charInfo.descent;
-                    var left = startX * pixelsPerUnitReciprocal;
-                    var right = (startX + w) * pixelsPerUnitReciprocal;
-                    var top = (startY + ascent) * pixelsPerUnitReciprocal;
-                    var bottom = (startY - descent + 1) * pixelsPerUnitReciprocal;
-                    localPositions.set(left, top, right, bottom);
-                    charRenderDatas[renderDataCount] = charRenderData;
-                    renderDataCount++;
-                    i === 0 && (maxY = Math.max(maxY, top));
-                    i === lastLineIndex && (minY = Math.min(minY, bottom));
-                    j === 0 && (minX = Math.min(minX, left));
-                    j === m && (maxX = Math.max(maxX, right));
-                }
-                startX += charInfo.xAdvance;
+            if (lineWidth > 0) {
+                var line = lines[i];
+                var startX = 0;
+                var firstRow = -1;
+                if (firstLine < 0) {
+                    firstLine = i;
+                }
+                switch(horizontalAlignment){
+                    case exports.TextHorizontalAlignment.Left:
+                        startX = -halfRendererWidth;
+                        break;
+                    case exports.TextHorizontalAlignment.Center:
+                        startX = -lineWidth * 0.5;
+                        break;
+                    case exports.TextHorizontalAlignment.Right:
+                        startX = halfRendererWidth - lineWidth;
+                        break;
+                }
+                for(var j = 0, n = line.length; j < n; ++j){
+                    var char = line[j];
+                    var charInfo = charFont._getCharInfo(char);
+                    if (charInfo.h > 0) {
+                        var _charRenderDatas, _ref;
+                        firstRow < 0 && (firstRow = j);
+                        var charRenderData = (_charRenderDatas = charRenderDatas)[_ref = renderDataCount++] || (_charRenderDatas[_ref] = charRenderDataPool.get());
+                        var renderData = charRenderData.renderData, localPositions = charRenderData.localPositions;
+                        charRenderData.texture = charFont._getTextureByIndex(charInfo.index);
+                        renderData.color = color;
+                        renderData.uvs = charInfo.uvs;
+                        var w = charInfo.w, ascent = charInfo.ascent, descent = charInfo.descent;
+                        var left = startX * pixelsPerUnitReciprocal;
+                        var right = (startX + w) * pixelsPerUnitReciprocal;
+                        var top = (startY + ascent) * pixelsPerUnitReciprocal;
+                        var bottom = (startY - descent + 1) * pixelsPerUnitReciprocal;
+                        localPositions.set(left, top, right, bottom);
+                        i === firstLine && (maxY = Math.max(maxY, top));
+                        minY = Math.min(minY, bottom);
+                        j === firstRow && (minX = Math.min(minX, left));
+                        maxX = Math.max(maxX, right);
+                    }
+                    startX += charInfo.xAdvance;
+                }
             }
             startY -= lineHeight;
         }
-        min.set(minX, minY, 0);
-        max.set(maxX, maxY, 0);
+        if (firstLine < 0) {
+            min.set(0, 0, 0);
+            max.set(0, 0, 0);
+        } else {
+            min.set(minX, minY, 0);
+            max.set(maxX, maxY, 0);
+        }
         // Revert excess render data to pool.
         var lastRenderDataCount = charRenderDatas.length;
         if (lastRenderDataCount > renderDataCount) {
@@ -21760,7 +22162,9 @@ var /**
             return a.texture.instanceId - b.texture.instanceId;
         });
     };
-    _proto._onTransformChanged = function _onTransformChanged(bit) {
+    /**
+   * @internal
+   */ _proto._onTransformChanged = function _onTransformChanged(bit) {
         Renderer.prototype._onTransformChanged.call(this, bit);
         this._setDirtyFlagTrue(0x4 | 0x8);
     };
@@ -22079,7 +22483,6 @@ var DirtyFlag;
  * @internal
  */ var AnimationCurveOwner = /*#__PURE__*/ function() {
     function AnimationCurveOwner(target, type, property, cureType) {
-        this.crossCurveMark = 0;
         this.hasSavedDefaultValue = false;
         this.baseEvaluateData = {
             curKeyframeIndex: 0,
@@ -22278,6 +22681,12 @@ AnimationCurveOwner.registerAssembler(Transform, "scale", ScaleAnimationCurveOwn
 }();
 AnimationCurveOwner.registerAssembler(SkinnedMeshRenderer, "blendShapeWeights", BlendShapeWeightsAnimationCurveOwnerAssembler);
 
+/**
+ * @internal
+ */ var AnimationCurveLayerOwner = function AnimationCurveLayerOwner() {
+    this.crossCurveMark = 0;
+};
+
 /**
  * Associate AnimationCurve and the Entity
  */ var AnimationClipCurveBinding = /*#__PURE__*/ function() {
@@ -22295,6 +22704,13 @@ AnimationCurveOwner.registerAssembler(SkinnedMeshRenderer, "blendShapeWeights",
     };
     /**
    * @internal
+   */ _proto._createCurveLayerOwner = function _createCurveLayerOwner(owner) {
+        var layerOwner = new AnimationCurveLayerOwner();
+        layerOwner.curveOwner = owner;
+        return layerOwner;
+    };
+    /**
+   * @internal
    */ _proto._getTempCurveOwner = function _getTempCurveOwner(entity) {
         var instanceId = entity.instanceId;
         if (!this._tempCurveOwner[instanceId]) {
@@ -23449,12 +23865,14 @@ exports.AnimatorLayerBlendingMode = void 0;
  * @internal
  */ var AnimatorLayerData = /*#__PURE__*/ function() {
     function AnimatorLayerData() {
+        this.curveOwnerPool = Object.create(null);
         this.animatorStateDataMap = {};
         this.srcPlayData = new AnimatorStatePlayData();
         this.destPlayData = new AnimatorStatePlayData();
         this.layerState = LayerState.Standby;
         this.crossCurveMark = 0;
         this.manuallyTransition = new AnimatorStateTransition();
+        this.crossOwnerLayerDataCollection = [];
     }
     var _proto = AnimatorLayerData.prototype;
     _proto.switchPlayData = function switchPlayData() {
@@ -23469,7 +23887,7 @@ exports.AnimatorLayerBlendingMode = void 0;
 /**
  * @internal
  */ var AnimatorStateData = function AnimatorStateData() {
-    this.curveOwners = [];
+    this.curveLayerOwner = [];
     this.eventHandlers = [];
 };
 
@@ -23483,8 +23901,7 @@ exports.AnimatorLayerBlendingMode = void 0;
         /** Culling mode of this Animator. */ _this.cullingMode = exports.AnimatorCullingMode.None;
         /** The playback speed of the Animator, 1.0 is normal playback speed. */ _this.speed = 1.0;
         _this._animatorLayersData = [];
-        _this._crossOwnerCollection = [];
-        _this._animationCurveOwners = [];
+        _this._curveOwnerPool = Object.create(null);
         _this._animationEventHandlerPool = new ClassPool(AnimationEventHandler);
         _this._tempAnimatorStateInfo = {
             layerIndex: -1,
@@ -23516,7 +23933,6 @@ exports.AnimatorLayerBlendingMode = void 0;
             return;
         }
         var animatorLayerData = this._getAnimatorLayerData(stateInfo.layerIndex);
-        //TODO CM: Not consider same stateName, but different animation
         var animatorStateData = this._getAnimatorStateData(stateName, state, animatorLayerData);
         this._preparePlay(animatorLayerData, state, animatorStateData);
         animatorLayerData.layerState = LayerState.Playing;
@@ -23607,7 +24023,7 @@ exports.AnimatorLayerBlendingMode = void 0;
     /**
    * @internal
    */ _proto._reset = function _reset() {
-        var _this = this, animationCurveOwners = _this._animationCurveOwners;
+        var _this = this, animationCurveOwners = _this._curveOwnerPool;
         for(var instanceId in animationCurveOwners){
             var propertyOwners = animationCurveOwners[instanceId];
             for(var property in propertyOwners){
@@ -23616,8 +24032,7 @@ exports.AnimatorLayerBlendingMode = void 0;
             }
         }
         this._animatorLayersData.length = 0;
-        this._crossOwnerCollection.length = 0;
-        this._animationCurveOwners.length = 0;
+        this._curveOwnerPool = {};
         this._animationEventHandlerPool.resetPool();
         if (this._controllerUpdateFlag) {
             this._controllerUpdateFlag.flag = false;
@@ -23645,10 +24060,10 @@ exports.AnimatorLayerBlendingMode = void 0;
         return stateInfo;
     };
     _proto._saveDefaultValues = function _saveDefaultValues(stateData) {
-        var curveOwners = stateData.curveOwners;
-        for(var i = curveOwners.length - 1; i >= 0; i--){
-            var _curveOwners_i;
-            (_curveOwners_i = curveOwners[i]) == null ? void 0 : _curveOwners_i.saveDefaultValue();
+        var curveLayerOwner = stateData.curveLayerOwner;
+        for(var i = curveLayerOwner.length - 1; i >= 0; i--){
+            var _curveLayerOwner_i;
+            (_curveLayerOwner_i = curveLayerOwner[i]) == null ? void 0 : _curveLayerOwner_i.curveOwner.saveDefaultValue();
         }
     };
     _proto._getAnimatorStateData = function _getAnimatorStateData(stateName, animatorState, animatorLayerData) {
@@ -23657,25 +24072,32 @@ exports.AnimatorLayerBlendingMode = void 0;
         if (!animatorStateData) {
             animatorStateData = new AnimatorStateData();
             animatorStateDataMap[stateName] = animatorStateData;
-            this._saveAnimatorStateData(animatorState, animatorStateData);
+            this._saveAnimatorStateData(animatorState, animatorStateData, animatorLayerData);
             this._saveAnimatorEventHandlers(animatorState, animatorStateData);
         }
         return animatorStateData;
     };
-    _proto._saveAnimatorStateData = function _saveAnimatorStateData(animatorState, animatorStateData) {
-        var _this = this, entity = _this.entity, animationCureOwners = _this._animationCurveOwners;
-        var curveOwners = animatorStateData.curveOwners;
+    _proto._saveAnimatorStateData = function _saveAnimatorStateData(animatorState, animatorStateData, animatorLayerData) {
+        var _this = this, entity = _this.entity, curveOwnerPool = _this._curveOwnerPool;
+        var curveLayerOwner = animatorStateData.curveLayerOwner;
+        var layerCurveOwnerPool = animatorLayerData.curveOwnerPool;
         var _animatorState_clip = animatorState.clip, curves = _animatorState_clip._curveBindings;
         for(var i = curves.length - 1; i >= 0; i--){
             var curve = curves[i];
             var targetEntity = curve.relativePath === "" ? entity : entity.findByPath(curve.relativePath);
             if (targetEntity) {
+                var _curveOwnerPool, _instanceId, _propertyOwners, _property, _layerCurveOwnerPool, _instanceId1, _layerPropertyOwners, _property1;
                 var property = curve.property;
                 var instanceId = targetEntity.instanceId;
-                var propertyOwners = animationCureOwners[instanceId] || (animationCureOwners[instanceId] = {});
-                curveOwners[i] = propertyOwners[property] || (propertyOwners[property] = curve._createCurveOwner(targetEntity));
+                // Get owner
+                var propertyOwners = (_curveOwnerPool = curveOwnerPool)[_instanceId = instanceId] || (_curveOwnerPool[_instanceId] = Object.create(null));
+                var owner = (_propertyOwners = propertyOwners)[_property = property] || (_propertyOwners[_property] = curve._createCurveOwner(targetEntity));
+                // Get layer owner
+                var layerPropertyOwners = (_layerCurveOwnerPool = layerCurveOwnerPool)[_instanceId1 = instanceId] || (_layerCurveOwnerPool[_instanceId1] = Object.create(null));
+                var layerOwner = (_layerPropertyOwners = layerPropertyOwners)[_property1 = property] || (_layerPropertyOwners[_property1] = curve._createCurveLayerOwner(owner));
+                curveLayerOwner[i] = layerOwner;
             } else {
-                curveOwners[i] = null;
+                curveLayerOwner[i] = null;
                 console.warn("The entity don't have the child entity which path is " + curve.relativePath + ".");
             }
         }
@@ -23703,65 +24125,61 @@ exports.AnimatorLayerBlendingMode = void 0;
     };
     _proto._clearCrossData = function _clearCrossData(animatorLayerData) {
         animatorLayerData.crossCurveMark++;
-        this._crossOwnerCollection.length = 0;
+        animatorLayerData.crossOwnerLayerDataCollection.length = 0;
     };
-    _proto._addCrossCurveData = function _addCrossCurveData(crossCurveData, owner, curCurveIndex, nextCurveIndex) {
-        owner.crossSrcCurveIndex = curCurveIndex;
-        owner.crossDestCurveIndex = nextCurveIndex;
-        crossCurveData.push(owner);
+    _proto._addCrossOwner = function _addCrossOwner(animatorLayerData, layerOwner, curCurveIndex, nextCurveIndex) {
+        layerOwner.crossSrcCurveIndex = curCurveIndex;
+        layerOwner.crossDestCurveIndex = nextCurveIndex;
+        animatorLayerData.crossOwnerLayerDataCollection.push(layerOwner);
     };
     _proto._prepareCrossFading = function _prepareCrossFading(animatorLayerData) {
-        var crossCurveData = this._crossOwnerCollection;
-        var crossCurveMark = animatorLayerData.crossCurveMark;
         // Add src cross curve data.
-        this._prepareSrcCrossData(crossCurveData, animatorLayerData.srcPlayData, crossCurveMark, false);
+        this._prepareSrcCrossData(animatorLayerData, false);
         // Add dest cross curve data.
-        this._prepareDestCrossData(crossCurveData, animatorLayerData.destPlayData, crossCurveMark, false);
+        this._prepareDestCrossData(animatorLayerData, false);
     };
     _proto._prepareStandbyCrossFading = function _prepareStandbyCrossFading(animatorLayerData) {
-        var crossOwnerCollection = this._crossOwnerCollection;
-        var srcPlayData = animatorLayerData.srcPlayData, crossCurveMark = animatorLayerData.crossCurveMark;
         // Standby have two sub state, one is never play, one is finished, never play srcPlayData.state is null.
-        srcPlayData.state && this._prepareSrcCrossData(crossOwnerCollection, srcPlayData, crossCurveMark, true);
+        animatorLayerData.srcPlayData.state && this._prepareSrcCrossData(animatorLayerData, true);
         // Add dest cross curve data.
-        this._prepareDestCrossData(crossOwnerCollection, animatorLayerData.destPlayData, crossCurveMark, true);
+        this._prepareDestCrossData(animatorLayerData, true);
     };
     _proto._prepareFixedPoseCrossFading = function _prepareFixedPoseCrossFading(animatorLayerData) {
-        var crossOwnerCollection = this._crossOwnerCollection;
+        var crossOwnerLayerDataCollection = animatorLayerData.crossOwnerLayerDataCollection;
         // Save current cross curve data owner fixed pose.
-        for(var i = crossOwnerCollection.length - 1; i >= 0; i--){
-            var item = crossOwnerCollection[i];
-            item.saveFixedPoseValue();
+        for(var i = crossOwnerLayerDataCollection.length - 1; i >= 0; i--){
+            var layerOwner = crossOwnerLayerDataCollection[i];
+            if (!layerOwner) continue;
+            layerOwner.curveOwner.saveFixedPoseValue();
             // Reset destCurveIndex When fixed pose crossFading again.
-            item.crossDestCurveIndex = -1;
+            layerOwner.crossDestCurveIndex = -1;
         }
         // prepare dest AnimatorState cross data.
-        this._prepareDestCrossData(crossOwnerCollection, animatorLayerData.destPlayData, animatorLayerData.crossCurveMark, true);
-    };
-    _proto._prepareSrcCrossData = function _prepareSrcCrossData(crossCurveData, srcPlayData, crossCurveMark, saveFixed) {
-        var curveOwners = srcPlayData.stateData.curveOwners;
-        for(var i = curveOwners.length - 1; i >= 0; i--){
-            var owner = curveOwners[i];
-            if (!owner) continue;
-            owner.crossCurveMark = crossCurveMark;
-            owner.crossCurveDataIndex = crossCurveData.length;
-            saveFixed && owner.saveFixedPoseValue();
-            this._addCrossCurveData(crossCurveData, owner, i, -1);
-        }
-    };
-    _proto._prepareDestCrossData = function _prepareDestCrossData(crossCurveData, destPlayData, crossCurveMark, saveFixed) {
-        var curveOwners = destPlayData.stateData.curveOwners;
-        for(var i = curveOwners.length - 1; i >= 0; i--){
-            var owner = curveOwners[i];
-            if (!owner) continue;
-            if (owner.crossCurveMark === crossCurveMark) {
-                crossCurveData[owner.crossCurveDataIndex].crossDestCurveIndex = i;
+        this._prepareDestCrossData(animatorLayerData, true);
+    };
+    _proto._prepareSrcCrossData = function _prepareSrcCrossData(animatorLayerData, saveFixed) {
+        var curveLayerOwner = animatorLayerData.srcPlayData.stateData.curveLayerOwner;
+        for(var i = curveLayerOwner.length - 1; i >= 0; i--){
+            var layerOwner = curveLayerOwner[i];
+            if (!layerOwner) continue;
+            layerOwner.crossCurveMark = animatorLayerData.crossCurveMark;
+            saveFixed && layerOwner.curveOwner.saveFixedPoseValue();
+            this._addCrossOwner(animatorLayerData, layerOwner, i, -1);
+        }
+    };
+    _proto._prepareDestCrossData = function _prepareDestCrossData(animatorLayerData, saveFixed) {
+        var curveLayerOwner = animatorLayerData.destPlayData.stateData.curveLayerOwner;
+        for(var i = curveLayerOwner.length - 1; i >= 0; i--){
+            var layerOwner = curveLayerOwner[i];
+            if (!layerOwner) continue;
+            if (layerOwner.crossCurveMark === animatorLayerData.crossCurveMark) {
+                layerOwner.crossDestCurveIndex = i;
             } else {
+                var owner = layerOwner.curveOwner;
                 owner.saveDefaultValue();
                 saveFixed && owner.saveFixedPoseValue();
-                owner.crossCurveMark = crossCurveMark;
-                owner.crossCurveDataIndex = crossCurveData.length;
-                this._addCrossCurveData(crossCurveData, owner, -1, i);
+                layerOwner.crossCurveMark = animatorLayerData.crossCurveMark;
+                this._addCrossOwner(animatorLayerData, layerOwner, -1, i);
             }
         }
     };
@@ -23791,7 +24209,7 @@ exports.AnimatorLayerBlendingMode = void 0;
         }
     };
     _proto._updatePlayingState = function _updatePlayingState(playData, layerData, layerIndex, weight, delta, additive, aniUpdate) {
-        var _playData_stateData = playData.stateData, curveOwners = _playData_stateData.curveOwners, eventHandlers = _playData_stateData.eventHandlers;
+        var _playData_stateData = playData.stateData, curveLayerOwner = _playData_stateData.curveLayerOwner, eventHandlers = _playData_stateData.eventHandlers;
         var state = playData.state, lastPlayState = playData.playState, lastClipTime = playData.clipTime;
         var _state_clip = state.clip, curveBindings = _state_clip._curveBindings;
         playData.update(this.speed < 0);
@@ -23801,8 +24219,8 @@ exports.AnimatorLayerBlendingMode = void 0;
         var clipTime = playData.clipTime, playState = playData.playState;
         eventHandlers.length && this._fireAnimationEvents(playData, eventHandlers, lastClipTime, clipTime);
         for(var i = curveBindings.length - 1; i >= 0; i--){
-            var owner = curveOwners[i];
-            owner == null ? void 0 : owner.evaluateAndApplyValue(curveBindings[i].curve, clipTime, weight, additive);
+            var _curveLayerOwner_i;
+            (_curveLayerOwner_i = curveLayerOwner[i]) == null ? void 0 : _curveLayerOwner_i.curveOwner.evaluateAndApplyValue(curveBindings[i].curve, clipTime, weight, additive);
         }
         playData.frameTime += state.speed * delta;
         if (playState === AnimatorStatePlayState.Finished) {
@@ -23818,7 +24236,7 @@ exports.AnimatorLayerBlendingMode = void 0;
         }
     };
     _proto._updateCrossFade = function _updateCrossFade(srcPlayData, destPlayData, layerData, layerIndex, weight, delta, additive, aniUpdate) {
-        var _this = this, crossCurveDataCollection = _this._crossOwnerCollection;
+        var crossOwnerLayerDataCollection = layerData.crossOwnerLayerDataCollection;
         var _srcPlayData_state_clip = srcPlayData.state.clip, srcCurves = _srcPlayData_state_clip._curveBindings;
         var srcState = srcPlayData.state, srcStateData = srcPlayData.stateData, lastSrcPlayState = srcPlayData.playState;
         var srcEventHandlers = srcStateData.eventHandlers;
@@ -23857,14 +24275,16 @@ exports.AnimatorLayerBlendingMode = void 0;
         } else {
             this._callAnimatorScriptOnUpdate(destState, layerIndex);
         }
-        for(var i = crossCurveDataCollection.length - 1; i >= 0; i--){
-            var crossCurveData = crossCurveDataCollection[i];
-            var crossSrcCurveIndex = crossCurveData.crossSrcCurveIndex, crossDestCurveIndex = crossCurveData.crossDestCurveIndex;
-            crossCurveData.crossFadeAndApplyValue(crossSrcCurveIndex >= 0 ? srcCurves[crossSrcCurveIndex].curve : null, crossDestCurveIndex >= 0 ? destCurves[crossDestCurveIndex].curve : null, srcClipTime, destClipTime, crossWeight, weight, additive);
+        for(var i = crossOwnerLayerDataCollection.length - 1; i >= 0; i--){
+            var layerOwner = crossOwnerLayerDataCollection[i];
+            if (!layerOwner) continue;
+            var srcCurveIndex = layerOwner.crossSrcCurveIndex;
+            var destCurveIndex = layerOwner.crossDestCurveIndex;
+            layerOwner.curveOwner.crossFadeAndApplyValue(srcCurveIndex >= 0 ? srcCurves[srcCurveIndex].curve : null, destCurveIndex >= 0 ? destCurves[destCurveIndex].curve : null, srcClipTime, destClipTime, crossWeight, weight, additive);
         }
     };
     _proto._updateCrossFadeFromPose = function _updateCrossFadeFromPose(destPlayData, layerData, layerIndex, layerWeight, delta, additive, aniUpdate) {
-        var crossCurveDataCollection = this._crossOwnerCollection;
+        var crossOwnerLayerDataCollection = layerData.crossOwnerLayerDataCollection;
         var state = destPlayData.state, stateData = destPlayData.stateData, lastPlayState = destPlayData.playState;
         var eventHandlers = stateData.eventHandlers;
         var _state_clip = state.clip, curveBindings = _state_clip._curveBindings;
@@ -23888,10 +24308,11 @@ exports.AnimatorLayerBlendingMode = void 0;
         } else {
             this._callAnimatorScriptOnUpdate(state, layerIndex);
         }
-        for(var i = crossCurveDataCollection.length - 1; i >= 0; i--){
-            var crossCurveData = crossCurveDataCollection[i];
-            var crossDestCurveIndex = crossCurveData.crossDestCurveIndex;
-            crossCurveData.crossFadeFromPoseAndApplyValue(crossDestCurveIndex >= 0 ? curveBindings[crossDestCurveIndex].curve : null, destClipTime, crossWeight, layerWeight, additive);
+        for(var i = crossOwnerLayerDataCollection.length - 1; i >= 0; i--){
+            var layerOwner = crossOwnerLayerDataCollection[i];
+            if (!layerOwner) continue;
+            var curveIndex = layerOwner.crossDestCurveIndex;
+            layerOwner.curveOwner.crossFadeFromPoseAndApplyValue(curveIndex >= 0 ? curveBindings[curveIndex].curve : null, destClipTime, crossWeight, layerWeight, additive);
         }
     };
     _proto._updateCrossFadeData = function _updateCrossFadeData(layerData, crossWeight, delta, fixed) {
@@ -23913,18 +24334,19 @@ exports.AnimatorLayerBlendingMode = void 0;
         if (layerData.layerState === LayerState.Playing) {
             var srcPlayData = layerData.srcPlayData;
             if (srcPlayData.state !== playState) {
-                var curveOwners = srcPlayData.stateData.curveOwners;
-                for(var i = curveOwners.length - 1; i >= 0; i--){
-                    var owner = curveOwners[i];
+                var curveLayerOwner = srcPlayData.stateData.curveLayerOwner;
+                for(var i = curveLayerOwner.length - 1; i >= 0; i--){
+                    var _curveLayerOwner_i;
+                    var owner = (_curveLayerOwner_i = curveLayerOwner[i]) == null ? void 0 : _curveLayerOwner_i.curveOwner;
                     (owner == null ? void 0 : owner.hasSavedDefaultValue) && owner.revertDefaultValue();
                 }
                 this._saveDefaultValues(playStateData);
             }
         } else {
             // layerState is CrossFading, FixedCrossFading, Standby
-            var crossCurveDataCollection = this._crossOwnerCollection;
-            for(var i1 = crossCurveDataCollection.length - 1; i1 >= 0; i1--){
-                var owner1 = crossCurveDataCollection[i1];
+            var crossOwnerLayerDataCollection = layerData.crossOwnerLayerDataCollection;
+            for(var i1 = crossOwnerLayerDataCollection.length - 1; i1 >= 0; i1--){
+                var owner1 = crossOwnerLayerDataCollection[i1].curveOwner;
                 owner1.hasSavedDefaultValue && owner1.revertDefaultValue();
             }
             this._saveDefaultValues(playStateData);
@@ -24094,10 +24516,7 @@ __decorate([
 ], Animator.prototype, "_animatorLayersData", void 0);
 __decorate([
     ignoreClone
-], Animator.prototype, "_crossOwnerCollection", void 0);
-__decorate([
-    ignoreClone
-], Animator.prototype, "_animationCurveOwners", void 0);
+], Animator.prototype, "_curveOwnerPool", void 0);
 __decorate([
     ignoreClone
 ], Animator.prototype, "_animationEventHandlerPool", void 0);
@@ -25530,7 +25949,9 @@ var _tempVector3 = new engineMath.Vector3();
             this.getMaterial().shaderData.setTexture("u_texture", texture);
         }
     };
-    _proto._render = function _render(context) {
+    /**
+   * @internal
+   */ _proto._render = function _render(context) {
         this._updateStrapVertices(context.camera, this._points);
         this._updateStrapCoords();
         this._vertexBuffer.setData(this._vertices);
@@ -25724,7 +26145,7 @@ var cacheDir = new engineMath.Vector3();
         /**
    * The position of the probe can be set, the default is the origin [0,0,0].
    */ _this.position = new engineMath.Vector3(0, 0, 0);
-        _this._isCube = true;
+        /** @internal */ _this._isCube = true;
         _this.oriViewMatrix = new engineMath.Matrix();
         return _this;
     }
@@ -25814,6 +26235,7 @@ exports.Basic2DBatcher = Basic2DBatcher;
 exports.BasicRenderPipeline = BasicRenderPipeline;
 exports.BlendShape = BlendShape;
 exports.BlendShapeFrame = BlendShapeFrame;
+exports.BlendState = BlendState;
 exports.BlinnPhongMaterial = BlinnPhongMaterial;
 exports.BoolUpdateFlag = BoolUpdateFlag;
 exports.BoxColliderShape = BoxColliderShape;
@@ -25827,6 +26249,7 @@ exports.ColliderShape = ColliderShape;
 exports.Component = Component;
 exports.ContentRestorer = ContentRestorer;
 exports.CubeProbe = CubeProbe;
+exports.DepthState = DepthState;
 exports.DirectLight = DirectLight;
 exports.DynamicCollider = DynamicCollider;
 exports.Engine = Engine;
@@ -25860,10 +26283,13 @@ exports.PointLight = PointLight;
 exports.Pointer = Pointer;
 exports.PrimitiveMesh = PrimitiveMesh;
 exports.Probe = Probe;
+exports.RasterState = RasterState;
 exports.ReferResource = ReferResource;
 exports.RenderPass = RenderPass;
 exports.RenderQueue = RenderQueue;
+exports.RenderState = RenderState;
 exports.RenderTarget = RenderTarget;
+exports.RenderTargetBlendState = RenderTargetBlendState;
 exports.ResourceManager = ResourceManager;
 exports.Scene = Scene;
 exports.SceneManager = SceneManager;
@@ -25890,6 +26316,7 @@ exports.SpriteMask = SpriteMask;
 exports.SpriteRenderer = SpriteRenderer;
 exports.StateMachineScript = StateMachineScript;
 exports.StaticCollider = StaticCollider;
+exports.StencilState = StencilState;
 exports.SubMesh = SubMesh;
 exports.SubShader = SubShader;
 exports.SystemInfo = SystemInfo;