@galacean/engine 1.0.0-beta.10 → 1.0.0-beta.12

package/dist/browser.js

@@ -5642,6 +5642,13 @@
         TextureFormat[TextureFormat[/** 16-bit depth + 8-bit stencil format. */ "Depth24Stencil8"] = 30] = "Depth24Stencil8";
         TextureFormat[TextureFormat[/** 32-bit depth + 8-bit stencil format. */ "Depth32Stencil8"] = 31] = "Depth32Stencil8";
     })(exports.TextureFormat || (exports.TextureFormat = {}));
+    /**
+     * Texture usage.
+     */ exports.TextureUsage = void 0;
+    (function(TextureUsage) {
+        TextureUsage[TextureUsage[/** The content of the texture is intended to be specified once.  */ "Static"] = 0] = "Static";
+        TextureUsage[TextureUsage[/** The content of the texture is intended to be updated frequently, with better performance. */ "Dynamic"] = 1] = "Dynamic";
+    })(exports.TextureUsage || (exports.TextureUsage = {}));
     /**
      * Wrapping mode of the texture.
      */ exports.TextureWrapMode = void 0;
@@ -5779,6 +5786,14 @@
                     return this._height;
                 }
             },
+            {
+                key: "usage",
+                get: /**
+       * The usage of the texture.
+       */ function get() {
+                    return this._usage;
+                }
+            },
             {
                 key: "wrapModeU",
                 get: /**
@@ -6019,14 +6034,16 @@
     /**
      * Two-dimensional texture.
      */ var Texture2D = /*#__PURE__*/ function(Texture) {
-        var Texture2D = function Texture2D(engine, width, height, format, mipmap) {
+        var Texture2D = function Texture2D(engine, width, height, format, mipmap, usage) {
             if (format === void 0) format = exports.TextureFormat.R8G8B8A8;
             if (mipmap === void 0) mipmap = true;
+            if (usage === void 0) usage = exports.TextureUsage.Static;
             var _this;
             _this = Texture.call(this, engine) || this;
             _this._mipmap = mipmap;
             _this._width = width;
             _this._height = height;
+            _this._usage = usage;
             _this._format = format;
             _this._mipmapCount = _this._getMipmapCount();
             _this._isDepthTexture = format == exports.TextureFormat.Depth || format == exports.TextureFormat.DepthStencil || format == exports.TextureFormat.Depth16 || format == exports.TextureFormat.Depth24 || format == exports.TextureFormat.Depth32 || format == exports.TextureFormat.Depth24Stencil8 || format == exports.TextureFormat.Depth32Stencil8;
@@ -7116,6 +7133,29 @@
        * @remarks The release principle is that it is not referenced by the components, including direct and indirect reference.
        */ _proto.gc = function gc() {
             this._gc(false);
+            var engine = this.engine;
+            engine._renderElementPool.garbageCollection();
+            engine._meshRenderDataPool.garbageCollection();
+            engine._spriteRenderDataPool.garbageCollection();
+            engine._spriteMaskRenderDataPool.garbageCollection();
+            engine._textRenderDataPool.garbageCollection();
+            var _componentsManager = engine._componentsManager, _lightManager = engine._lightManager;
+            _componentsManager._renderers.garbageCollection();
+            // @ts-ignore
+            _componentsManager._onStartScripts.garbageCollection();
+            // @ts-ignore
+            _componentsManager._onUpdateScripts.garbageCollection();
+            // @ts-ignore
+            _componentsManager._onLateUpdateScripts.garbageCollection();
+            // @ts-ignore
+            _componentsManager._onPhysicsUpdateScripts.garbageCollection();
+            // @ts-ignore
+            _componentsManager._onUpdateAnimations.garbageCollection();
+            // @ts-ignore
+            _componentsManager._onUpdateRenderers.garbageCollection();
+            _lightManager._spotLights.garbageCollection();
+            _lightManager._pointLights.garbageCollection();
+            _lightManager._directLights.garbageCollection();
         };
         /**
        * Add content restorer.
@@ -9532,6 +9572,11 @@
        * @returns Cloned entity
        */ _proto.clone = function clone() {
             var cloneEntity = new Entity(this._engine, this.name);
+            var _this = this, hookResource = _this._hookResource;
+            if (hookResource) {
+                cloneEntity._hookResource = hookResource;
+                hookResource._addReferCount(1);
+            }
             cloneEntity._isActive = this._isActive;
             cloneEntity.transform.localMatrix = this.transform.localMatrix;
             var children = this._children;
@@ -9556,6 +9601,10 @@
                 return;
             }
             EngineObject.prototype.destroy.call(this);
+            if (this._hookResource) {
+                this._hookResource._addReferCount(-1);
+                this._hookResource = null;
+            }
             var components = this._components;
             for(var i = components.length - 1; i >= 0; i--){
                 components[i].destroy();
@@ -14146,9 +14195,9 @@
         var Material = function Material(engine, shader) {
             var _this;
             _this = ReferResource.call(this, engine) || this;
-            /** Shader data. */ _this.shaderData = new ShaderData(ShaderDataGroup.Material);
             /** @internal */ _this._renderStates = [] // todo: later will as a part of shaderData when shader effect frame is OK, that is more powerful and flexible.
             ;
+            _this._shaderData = new ShaderData(ShaderDataGroup.Material);
             _this.shader = shader;
             return _this;
         };
@@ -14173,7 +14222,23 @@
             ReferResource.prototype._addReferCount.call(this, value);
             this.shaderData._addReferCount(value);
         };
+        /**
+       * @override
+       */ _proto._onDestroy = function _onDestroy() {
+            this._shader = null;
+            this._shaderData = null;
+            this._renderStates.length = 0;
+            this._renderStates = null;
+        };
         _create_class$3(Material, [
+            {
+                key: "shaderData",
+                get: /**
+       *  Shader data.
+       */ function get() {
+                    return this._shaderData;
+                }
+            },
             {
                 key: "shader",
                 get: /**
@@ -14245,6 +14310,12 @@
        */ _proto.resetPool = function resetPool() {
             this._elementPoolIndex = 0;
         };
+        _proto.garbageCollection = function garbageCollection() {
+            var _this = this, pool = _this._elementPool;
+            for(var i = pool.length - 1; i >= 0; i--){
+                pool[i].dispose && pool[i].dispose();
+            }
+        };
         return ClassPool;
     }();
     var RenderData = function RenderData() {};
@@ -14262,6 +14333,9 @@
             this.mesh = mesh;
             this.subMesh = subMesh;
         };
+        _proto.dispose = function dispose() {
+            this.component = this.material = this.mesh = this.subMesh = null;
+        };
         return MeshRenderData;
     }(RenderData);
     /**
@@ -15334,6 +15408,9 @@
             this.shaderPass = shaderPass;
             this.renderState = renderState;
         };
+        _proto.dispose = function dispose() {
+            this.data = this.shaderPass = this.renderState = null;
+        };
         return RenderElement;
     }();
     /**
@@ -15350,7 +15427,6 @@
         var Renderer1 = function Renderer1(entity) {
             var _this;
             _this = Component.call(this, entity) || this;
-            /** ShaderData related to renderer. */ _this.shaderData = new ShaderData(ShaderDataGroup.Renderer);
             /** @internal */ _this._onUpdateIndex = -1;
             /** @internal */ _this._rendererIndex = -1;
             /** @internal */ _this._globalShaderMacro = new ShaderMacroCollection();
@@ -15358,6 +15434,7 @@
             _this._overrideUpdate = false;
             _this._materials = [];
             _this._dirtyUpdateFlag = 0;
+            _this._shaderData = new ShaderData(ShaderDataGroup.Renderer);
             _this._mvMatrix = new Matrix();
             _this._mvpMatrix = new Matrix();
             _this._mvInvMatrix = new Matrix();
@@ -15504,6 +15581,17 @@
                 var _materials_i;
                 (_materials_i = materials[i]) == null ? void 0 : _materials_i._addReferCount(-1);
             }
+            this._entity = null;
+            this._globalShaderMacro = null;
+            this._bounds = null;
+            this._materials = null;
+            this._shaderData = null;
+            this._mvMatrix = null;
+            this._mvpMatrix = null;
+            this._mvInvMatrix = null;
+            this._normalMatrix = null;
+            this._materialsInstanced = null;
+            this._rendererLayer = null;
         };
         /**
        * @internal
@@ -15579,6 +15667,14 @@
             this._dirtyUpdateFlag |= 0x1;
         };
         _create_class$3(Renderer1, [
+            {
+                key: "shaderData",
+                get: /**
+       * ShaderData related to renderer.
+       */ function get() {
+                    return this._shaderData;
+                }
+            },
             {
                 key: "isCulled",
                 get: /**
@@ -15663,9 +15759,6 @@
     }(), function() {
         _Renderer._rendererLayerProperty = ShaderProperty.getByName("renderer_Layer");
     }(), _Renderer);
-    __decorate$1([
-        deepClone
-    ], exports.Renderer.prototype, "shaderData", void 0);
     __decorate$1([
         ignoreClone
     ], exports.Renderer.prototype, "_distanceForSort", void 0);
@@ -15693,6 +15786,9 @@
     __decorate$1([
         ignoreClone
     ], exports.Renderer.prototype, "_dirtyUpdateFlag", void 0);
+    __decorate$1([
+        deepClone
+    ], exports.Renderer.prototype, "_shaderData", void 0);
     __decorate$1([
         ignoreClone
     ], exports.Renderer.prototype, "_mvMatrix", void 0);
@@ -15942,6 +16038,7 @@
                 sprite._addReferCount(-1);
                 sprite._updateFlagManager.removeListener(this._onSpriteChange);
             }
+            this._entity = null;
             this._sprite = null;
             this._verticesData = null;
         };
@@ -16485,14 +16582,19 @@
     }();
     /**
      * Sub-mesh, mainly contains drawing information.
-     */ var SubMesh = function SubMesh(start, count, topology) {
-        if (start === void 0) start = 0;
-        if (count === void 0) count = 0;
-        if (topology === void 0) topology = exports.MeshTopology.Triangles;
-        this.start = start;
-        this.count = count;
-        this.topology = topology;
-    };
+     */ var SubMesh = /*#__PURE__*/ function() {
+        var SubMesh = function SubMesh(start, count, topology) {
+            if (start === void 0) start = 0;
+            if (count === void 0) count = 0;
+            if (topology === void 0) topology = exports.MeshTopology.Triangles;
+            this.start = start;
+            this.count = count;
+            this.topology = topology;
+        };
+        var _proto = SubMesh.prototype;
+        _proto.dispose = function dispose() {};
+        return SubMesh;
+    }();
     /**
      * Mesh.
      */ var Mesh = /*#__PURE__*/ function(GraphicsResource) {
@@ -18241,8 +18343,8 @@
        */ _proto._onDestroy = function _onDestroy() {
             Renderer.prototype._onDestroy.call(this);
             var mesh = this._mesh;
-            if (mesh && !mesh.destroyed) {
-                mesh._addReferCount(-1);
+            if (mesh) {
+                mesh.destroyed || mesh._addReferCount(-1);
                 mesh._updateFlagManager.removeListener(this._onMeshChanged);
                 this._mesh = null;
             }
@@ -18497,10 +18599,21 @@
         /**
        * @internal
        */ _proto._onDestroy = function _onDestroy() {
-            var _this_rootBone, _this__jointTexture;
+            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__rootBone = this._rootBone) == null ? void 0 : _this__rootBone.transform._updateFlagManager.removeListener(this._onTransformChanged);
+            this._rootBone = null;
+            this._jointDataCreateCache = null;
+            this._skin = null;
+            this._blendShapeWeights = null;
+            this._localBounds = null;
+            this._jointMatrices = null;
             (_this__jointTexture = this._jointTexture) == null ? void 0 : _this__jointTexture.destroy();
+            this._jointTexture = null;
+            if (this._jointEntities) {
+                this._jointEntities.length = 0;
+                this._jointEntities = null;
+            }
         };
         /**
        * @internal
@@ -20188,6 +20301,9 @@
             this.material = material;
             this.verticesData = verticesData;
         };
+        _proto.dispose = function dispose() {
+            this.component = this.material = this.verticesData = null;
+        };
         return SpriteMaskRenderData;
     }(RenderData);
     var SpriteRenderData = /*#__PURE__*/ function(RenderData) {
@@ -20207,6 +20323,9 @@
             this.texture = texture;
             this.dataIndex = dataIndex;
         };
+        _proto.dispose = function dispose() {
+            this.component = this.material = this.verticesData = this.texture = null;
+        };
         return SpriteRenderData;
     }(RenderData);
     var TextRenderData = /*#__PURE__*/ function(RenderData) {
@@ -20218,6 +20337,11 @@
             return _this;
         };
         _inherits$2(TextRenderData, RenderData);
+        var _proto = TextRenderData.prototype;
+        _proto.dispose = function dispose() {
+            this.component = this.material = null;
+            this.charsData.length = 0;
+        };
         return TextRenderData;
     }(RenderData);
     /**
@@ -20743,8 +20867,6 @@
         function Scene(engine, name) {
             var _this;
             _this = EngineObject.call(this, engine) || this;
-            /** The background of the scene. */ _this.background = new Background(_this._engine);
-            /** Scene-related shader data. */ _this.shaderData = new ShaderData(ShaderDataGroup.Scene);
             /** If cast shadows. */ _this.castShadows = true;
             /** The resolution of the shadow maps. */ _this.shadowResolution = exports.ShadowResolution.Medium;
             /** The splits of two cascade distribution. */ _this.shadowTwoCascadeSplits = 1.0 / 3.0;
@@ -20754,6 +20876,8 @@
             /** @internal */ _this._isActiveInEngine = false;
             /** @internal */ _this._globalShaderMacro = new ShaderMacroCollection();
             /** @internal */ _this._rootEntities = [];
+            _this._background = new Background(_this._engine);
+            _this._shaderData = new ShaderData(ShaderDataGroup.Scene);
             _this._shadowCascades = exports.ShadowCascadesMode.NoCascades;
             _this._fogMode = exports.FogMode.None;
             _this._fogColor = new Color$1(0.5, 0.5, 0.5, 1.0);
@@ -20920,6 +21044,8 @@
                 shaderData.setColor(Scene._sunlightColorProperty, sunlight._getLightIntensityColor());
                 shaderData.setVector3(Scene._sunlightDirectionProperty, sunlight.direction);
                 this._sunLight = sunlight;
+            } else {
+                this._sunLight = null;
             }
             if (this.castShadows && this._sunLight && this._sunLight.shadowType !== exports.ShadowType.None) {
                 shaderData.enableMacro("SCENE_SHADOW_TYPE", this._sunLight.shadowType.toString());
@@ -20979,6 +21105,22 @@
             this._fogParams.w = density / Math.sqrt(Math.LN2);
         };
         _create_class$3(Scene, [
+            {
+                key: "shaderData",
+                get: /**
+       * Scene-related shader data.
+       */ function get() {
+                    return this._shaderData;
+                }
+            },
+            {
+                key: "background",
+                get: /**
+       * The background of the scene.
+       */ function get() {
+                    return this._background;
+                }
+            },
             {
                 key: "shadowCascades",
                 get: /**
@@ -23410,7 +23552,6 @@
         var Camera1 = function Camera1(entity) {
             var _this;
             _this = Component.call(this, entity) || this;
-            /** Shader data. */ _this.shaderData = new ShaderData(ShaderDataGroup.Camera);
             /** Rendering priority - A Camera with higher priority will be rendered on top of a camera with lower priority. */ _this.priority = 0;
             /** Whether to enable frustum culling, it is enabled by default. */ _this.enableFrustumCulling = true;
             /**
@@ -23426,6 +23567,7 @@
             /** @internal */ _this._virtualCamera = new VirtualCamera();
             /** @internal */ _this._replacementShader = null;
             /** @internal */ _this._replacementSubShaderTag = null;
+            _this._shaderData = new ShaderData(ShaderDataGroup.Camera);
             _this._isProjMatSetting = false;
             _this._nearClipPlane = 0.1;
             _this._farClipPlane = 100;
@@ -23636,6 +23778,20 @@
             this._isInvViewProjDirty.destroy();
             this._isViewMatrixDirty.destroy();
             this.shaderData._addReferCount(-1);
+            this._entity = null;
+            this._globalShaderMacro = null;
+            this._frustum = null;
+            this._renderPipeline = null;
+            this._virtualCamera = null;
+            this._shaderData = null;
+            this._frustumViewChangeFlag = null;
+            this._transform = null;
+            this._isViewMatrixDirty = null;
+            this._isInvViewProjDirty = null;
+            this._viewport = null;
+            this._inverseProjectionMatrix = null;
+            this._lastAspectSize = null;
+            this._invViewProjMat = null;
         };
         _proto._projMatChange = function _projMatChange() {
             this._isFrustumProjectDirty = true;
@@ -23675,6 +23831,14 @@
             return this._inverseProjectionMatrix;
         };
         _create_class$3(Camera1, [
+            {
+                key: "shaderData",
+                get: /**
+       * Shader data.
+       */ function get() {
+                    return this._shaderData;
+                }
+            },
             {
                 key: "nearClipPlane",
                 get: /**
@@ -26064,6 +26228,7 @@
                 sprite._addReferCount(-1);
                 sprite._updateFlagManager.removeListener(this._onSpriteChange);
             }
+            this._entity = null;
             this._color = null;
             this._sprite = null;
             this._assembler = null;
@@ -28336,9 +28501,14 @@
     })(LayerState || (LayerState = {}));
     /**
      * @internal
-     */ var AnimationEventHandler = function AnimationEventHandler() {
-        this.handlers = [];
-    };
+     */ var AnimationEventHandler = /*#__PURE__*/ function() {
+        var AnimationEventHandler = function AnimationEventHandler() {
+            this.handlers = [];
+        };
+        var _proto = AnimationEventHandler.prototype;
+        _proto.dispose = function dispose() {};
+        return AnimationEventHandler;
+    }();
     /**
      * Transitions define when and how the state machine switch from on state to another. AnimatorTransition always originate from a StateMachine or a StateMachine entry.
      */ var AnimatorStateTransition = function AnimatorStateTransition() {
@@ -30909,6 +31079,7 @@
         get TextureDepthCompareFunction () { return exports.TextureDepthCompareFunction; },
         get TextureFilterMode () { return exports.TextureFilterMode; },
         get TextureFormat () { return exports.TextureFormat; },
+        get TextureUsage () { return exports.TextureUsage; },
         get TextureWrapMode () { return exports.TextureWrapMode; },
         Time: Time,
         TrailMaterial: TrailMaterial,
@@ -31676,9 +31847,9 @@
             var isWebGL2 = this._isWebGL2;
             var _this__formatDetail = this._formatDetail, internalFormat = _this__formatDetail.internalFormat, baseFormat = _this__formatDetail.baseFormat, dataType = _this__formatDetail.dataType;
             // @ts-ignore
-            var _this__texture = this._texture, mipmapCount = _this__texture.mipmapCount, width = _this__texture.width, height = _this__texture.height, _isDepthTexture = _this__texture._isDepthTexture;
+            var _this__texture = this._texture, mipmapCount = _this__texture.mipmapCount, width = _this__texture.width, height = _this__texture.height, usage = _this__texture.usage, _isDepthTexture = _this__texture._isDepthTexture;
             this._bind();
-            if (isWebGL2 && !(baseFormat === gl.LUMINANCE_ALPHA || baseFormat === gl.ALPHA)) {
+            if (isWebGL2 && !(baseFormat === gl.LUMINANCE_ALPHA || baseFormat === gl.ALPHA) && usage !== exports.TextureUsage.Dynamic) {
                 gl.texStorage2D(this._target, mipmapCount, internalFormat, width, height);
             } else {
                 if (!isCube) {
@@ -32470,11 +32641,15 @@
        * {@inheritDoc IPlatformTexture2D.setImageSource}
        */ _proto.setImageSource = function setImageSource(imageSource, mipLevel, flipY, premultiplyAlpha, x, y) {
             var gl = this._gl;
-            var _this__formatDetail = this._formatDetail, baseFormat = _this__formatDetail.baseFormat, dataType = _this__formatDetail.dataType;
+            var _this__formatDetail = this._formatDetail, internalFormat = _this__formatDetail.internalFormat, baseFormat = _this__formatDetail.baseFormat, dataType = _this__formatDetail.dataType;
             this._bind();
             gl.pixelStorei(gl.UNPACK_FLIP_Y_WEBGL, +flipY);
             gl.pixelStorei(gl.UNPACK_PREMULTIPLY_ALPHA_WEBGL, +premultiplyAlpha);
-            gl.texSubImage2D(this._target, mipLevel, x || 0, y || 0, baseFormat, dataType, imageSource);
+            if (this._texture.usage === exports.TextureUsage.Dynamic) {
+                gl.texImage2D(this._target, mipLevel, internalFormat, baseFormat, dataType, imageSource);
+            } else {
+                gl.texSubImage2D(this._target, mipLevel, x || 0, y || 0, baseFormat, dataType, imageSource);
+            }
         };
         /**
        * {@inheritDoc IPlatformTexture2D.getPixelBuffer }
@@ -34817,6 +34992,10 @@
             }
             glTFResource.sceneRoots = sceneRoots;
             glTFResource.defaultSceneRoot = sceneRoots[sceneID];
+            // @ts-ignore
+            glTFResource.defaultSceneRoot._hookResource = glTFResource;
+            // @ts-ignore
+            glTFResource._addReferCount(1);
         };
         return GLTFEntityParser;
     }(GLTFParser);
@@ -35548,33 +35727,16 @@
     })();
     /**
      * Product after glTF parser, usually, `defaultSceneRoot` is only needed to use.
-     */ var GLTFResource = /*#__PURE__*/ function(EngineObject) {
+     */ var GLTFResource = /*#__PURE__*/ function(ReferResource) {
         var GLTFResource = function GLTFResource(engine, url) {
             var _this;
-            _this = EngineObject.call(this, engine) || this;
+            _this = ReferResource.call(this, engine) || this;
             _this.url = url;
             return _this;
         };
-        _inherits(GLTFResource, EngineObject);
-        var _proto = GLTFResource.prototype;
-        /**
-       * @internal
-       */ _proto._onDestroy = function _onDestroy() {
-            EngineObject.prototype._onDestroy.call(this);
-            this.defaultSceneRoot.destroy();
-            this.textures = null;
-            this.materials = null;
-            this.meshes = null;
-            this.skins = null;
-            this.animations = null;
-            this.entities = null;
-            this.cameras = null;
-            this.lights = null;
-            this.sceneRoots = null;
-            this.extensionsData = null;
-        };
+        _inherits(GLTFResource, ReferResource);
         return GLTFResource;
-    }(EngineObject);
+    }(ReferResource);
     var GLTFLoader = /*#__PURE__*/ function(Loader) {
         var GLTFLoader = function GLTFLoader() {
             return Loader.apply(this, arguments);
@@ -38016,7 +38178,7 @@
     ], GALACEAN_animation_event);
 
     //@ts-ignore
-    var version = "1.0.0-beta.10";
+    var version = "1.0.0-beta.12";
     console.log("Galacean engine version: " + version);
     for(var key in CoreObjects){
         Loader.registerClass(key, CoreObjects[key]);