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

package/dist/main.js

@@ -798,6 +798,14 @@ __decorate([
     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;
@@ -938,6 +946,14 @@ var Logger = {
                 return this._height;
             }
         },
+        {
+            key: "usage",
+            get: /**
+   * The usage of the texture.
+   */ function get() {
+                return this._usage;
+            }
+        },
         {
             key: "wrapModeU",
             get: /**
@@ -1181,14 +1197,16 @@ var Logger = {
  * Two-dimensional texture.
  */ var Texture2D = /*#__PURE__*/ function(Texture) {
     _inherits(Texture2D, Texture);
-    function Texture2D(engine, width, height, format, mipmap) {
+    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;
@@ -2288,6 +2306,29 @@ var /** @internal */ PromiseState;
    * @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.
@@ -4723,6 +4764,11 @@ var ComponentCloner = /*#__PURE__*/ function() {
    * @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;
@@ -4747,6 +4793,10 @@ var ComponentCloner = /*#__PURE__*/ function() {
             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();
@@ -9401,9 +9451,9 @@ __decorate([
     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;
     }
@@ -9427,7 +9477,23 @@ __decorate([
         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(Material, [
+        {
+            key: "shaderData",
+            get: /**
+   *  Shader data.
+   */ function get() {
+                return this._shaderData;
+            }
+        },
         {
             key: "shader",
             get: /**
@@ -9500,6 +9566,12 @@ __decorate([
    */ _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;
 }();
 
@@ -9520,6 +9592,9 @@ var RenderData = function RenderData() {
         this.mesh = mesh;
         this.subMesh = subMesh;
     };
+    _proto.dispose = function dispose() {
+        this.component = this.material = this.mesh = this.subMesh = null;
+    };
     return MeshRenderData;
 }(RenderData);
 
@@ -10665,6 +10740,9 @@ var RenderElement = /*#__PURE__*/ function() {
         this.shaderPass = shaderPass;
         this.renderState = renderState;
     };
+    _proto.dispose = function dispose() {
+        this.data = this.shaderPass = this.renderState = null;
+    };
     return RenderElement;
 }();
 
@@ -10684,7 +10762,6 @@ exports.Renderer = (_Renderer = /*#__PURE__*/ function(Component) {
     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();
@@ -10692,6 +10769,7 @@ exports.Renderer = (_Renderer = /*#__PURE__*/ function(Component) {
         _this._overrideUpdate = false;
         _this._materials = [];
         _this._dirtyUpdateFlag = 0;
+        _this._shaderData = new ShaderData(ShaderDataGroup.Renderer);
         _this._mvMatrix = new engineMath.Matrix();
         _this._mvpMatrix = new engineMath.Matrix();
         _this._mvInvMatrix = new engineMath.Matrix();
@@ -10837,6 +10915,17 @@ exports.Renderer = (_Renderer = /*#__PURE__*/ function(Component) {
             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
@@ -10912,6 +11001,14 @@ exports.Renderer = (_Renderer = /*#__PURE__*/ function(Component) {
         this._dirtyUpdateFlag |= 0x1;
     };
     _create_class(Renderer1, [
+        {
+            key: "shaderData",
+            get: /**
+   * ShaderData related to renderer.
+   */ function get() {
+                return this._shaderData;
+            }
+        },
         {
             key: "isCulled",
             get: /**
@@ -10996,9 +11093,6 @@ exports.Renderer = (_Renderer = /*#__PURE__*/ function(Component) {
 }(), function() {
     _Renderer._rendererLayerProperty = ShaderProperty.getByName("renderer_Layer");
 }(), _Renderer);
-__decorate([
-    deepClone
-], exports.Renderer.prototype, "shaderData", void 0);
 __decorate([
     ignoreClone
 ], exports.Renderer.prototype, "_distanceForSort", void 0);
@@ -11026,6 +11120,9 @@ __decorate([
 __decorate([
     ignoreClone
 ], exports.Renderer.prototype, "_dirtyUpdateFlag", void 0);
+__decorate([
+    deepClone
+], exports.Renderer.prototype, "_shaderData", void 0);
 __decorate([
     ignoreClone
 ], exports.Renderer.prototype, "_mvMatrix", void 0);
@@ -11282,6 +11379,7 @@ SimpleSpriteAssembler = __decorate([
             sprite._addReferCount(-1);
             sprite._updateFlagManager.removeListener(this._onSpriteChange);
         }
+        this._entity = null;
         this._sprite = null;
         this._verticesData = null;
     };
@@ -11836,14 +11934,19 @@ var BufferUtil = /*#__PURE__*/ function() {
 
 /**
  * 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() {
+    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.
@@ -13599,8 +13702,8 @@ var VertexChangedFlags;
    */ _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;
         }
@@ -13856,10 +13959,21 @@ var /**
     /**
    * @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
@@ -15561,6 +15675,9 @@ var SpriteMaskRenderData = /*#__PURE__*/ function(RenderData) {
         this.material = material;
         this.verticesData = verticesData;
     };
+    _proto.dispose = function dispose() {
+        this.component = this.material = this.verticesData = null;
+    };
     return SpriteMaskRenderData;
 }(RenderData);
 
@@ -15581,6 +15698,9 @@ var SpriteRenderData = /*#__PURE__*/ function(RenderData) {
         this.texture = texture;
         this.dataIndex = dataIndex;
     };
+    _proto.dispose = function dispose() {
+        this.component = this.material = this.verticesData = this.texture = null;
+    };
     return SpriteRenderData;
 }(RenderData);
 
@@ -15593,6 +15713,11 @@ var TextRenderData = /*#__PURE__*/ function(RenderData) {
         _this.multiRenderData = true;
         return _this;
     }
+    var _proto = TextRenderData.prototype;
+    _proto.dispose = function dispose() {
+        this.component = this.material = null;
+        this.charsData.length = 0;
+    };
     return TextRenderData;
 }(RenderData);
 
@@ -16126,8 +16251,6 @@ var TextRenderData = /*#__PURE__*/ function(RenderData) {
     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;
@@ -16137,6 +16260,8 @@ var TextRenderData = /*#__PURE__*/ function(RenderData) {
         /** @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 engineMath.Color(0.5, 0.5, 0.5, 1.0);
@@ -16303,6 +16428,8 @@ var TextRenderData = /*#__PURE__*/ function(RenderData) {
             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());
@@ -16362,6 +16489,22 @@ var TextRenderData = /*#__PURE__*/ function(RenderData) {
         this._fogParams.w = density / Math.sqrt(Math.LN2);
     };
     _create_class(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: /**
@@ -18830,7 +18973,6 @@ exports.Camera = (_Camera = /*#__PURE__*/ function(Component) {
     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;
         /**
@@ -18846,6 +18988,7 @@ exports.Camera = (_Camera = /*#__PURE__*/ function(Component) {
         /** @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;
@@ -19055,6 +19198,20 @@ exports.Camera = (_Camera = /*#__PURE__*/ function(Component) {
         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;
@@ -19094,6 +19251,14 @@ exports.Camera = (_Camera = /*#__PURE__*/ function(Component) {
         return this._inverseProjectionMatrix;
     };
     _create_class(Camera1, [
+        {
+            key: "shaderData",
+            get: /**
+   * Shader data.
+   */ function get() {
+                return this._shaderData;
+            }
+        },
         {
             key: "nearClipPlane",
             get: /**
@@ -21503,6 +21668,7 @@ var TiledType;
             sprite._addReferCount(-1);
             sprite._updateFlagManager.removeListener(this._onSpriteChange);
         }
+        this._entity = null;
         this._color = null;
         this._sprite = null;
         this._assembler = null;
@@ -23805,9 +23971,14 @@ exports.AnimatorLayerBlendingMode = void 0;
 
 /**
  * @internal
- */ var AnimationEventHandler = function AnimationEventHandler() {
-    this.handlers = [];
-};
+ */ var AnimationEventHandler = /*#__PURE__*/ function() {
+    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.