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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@galacean/engine-core",
-  "version": "1.0.0-beta.10",
+  "version": "1.0.0-beta.12",
   "publishConfig": {
     "access": "public",
     "registry": "https://registry.npmjs.org"
@@ -15,10 +15,10 @@
     "types/**/*"
   ],
   "dependencies": {
-    "@galacean/engine-math": "1.0.0-beta.10"
+    "@galacean/engine-math": "1.0.0-beta.12"
   },
   "devDependencies": {
-    "@galacean/engine-design": "1.0.0-beta.10"
+    "@galacean/engine-design": "1.0.0-beta.12"
   },
   "scripts": {
     "b:types": "tsc"

package/types/Camera.d.ts

@@ -12,8 +12,6 @@ import { RenderTarget } from "./texture/RenderTarget";
  * @decorator `@dependentComponents(Transform, DependentMode.CheckOnly)`
  */
 export declare class Camera extends Component {
-    /** Shader data. */
-    readonly shaderData: ShaderData;
     /** Rendering priority - A Camera with higher priority will be rendered on top of a camera with lower priority. */
     priority: number;
     /** Whether to enable frustum culling, it is enabled by default. */
@@ -28,6 +26,7 @@ export declare class Camera extends Component {
      * @remarks Support bit manipulation, corresponding to `Layer`.
      */
     cullingMask: Layer;
+    private _shaderData;
     private _isProjMatSetting;
     private _nearClipPlane;
     private _farClipPlane;
@@ -46,6 +45,10 @@ export declare class Camera extends Component {
     private _inverseProjectionMatrix;
     private _lastAspectSize;
     private _invViewProjMat;
+    /**
+     * Shader data.
+     */
+    get shaderData(): ShaderData;
     /**
      * Near clip plane - the closest point to the camera when rendering occurs.
      */

package/types/RenderPipeline/ClassPool.d.ts

@@ -1,7 +1,8 @@
+import { IPoolElement } from "./IPoolElement";
 /**
  * Class pool utils.
  */
-export declare class ClassPool<T> {
+export declare class ClassPool<T extends IPoolElement> {
     private _elementPoolIndex;
     private _elementPool;
     private _type;
@@ -14,4 +15,5 @@ export declare class ClassPool<T> {
      * Reset pool.
      */
     resetPool(): void;
+    garbageCollection(): void;
 }

package/types/RenderPipeline/IPoolElement.d.ts

@@ -0,0 +1,3 @@
+export interface IPoolElement {
+    dispose?(): void;
+}

package/types/RenderPipeline/MeshRenderData.d.ts

@@ -2,14 +2,16 @@ import { Mesh } from "../graphic/Mesh";
 import { SubMesh } from "../graphic/SubMesh";
 import { Material } from "../material/Material";
 import { Renderer } from "../Renderer";
+import { IPoolElement } from "./IPoolElement";
 import { RenderData } from "./RenderData";
 /**
  * Render element.
  */
-export declare class MeshRenderData extends RenderData {
+export declare class MeshRenderData extends RenderData implements IPoolElement {
     /** Mesh. */
     mesh: Mesh;
     /** Sub mesh. */
     subMesh: SubMesh;
     set(component: Renderer, material: Material, mesh: Mesh, subMesh: SubMesh): void;
+    dispose(): void;
 }

package/types/RenderPipeline/RenderElement.d.ts

@@ -1,9 +1,11 @@
 import { ShaderPass } from "../shader/ShaderPass";
 import { RenderState } from "../shader/state/RenderState";
+import { IPoolElement } from "./IPoolElement";
 import { RenderData } from "./RenderData";
-export declare class RenderElement {
+export declare class RenderElement implements IPoolElement {
     data: RenderData;
     shaderPass: ShaderPass;
     renderState: RenderState;
     set(data: RenderData, shaderPass: ShaderPass, renderState: RenderState): void;
+    dispose(): void;
 }

package/types/RenderPipeline/SpriteMaskRenderData.d.ts

@@ -1,10 +1,12 @@
 import { VertexData2D } from "../2d/data/VertexData2D";
 import { Material } from "../material/Material";
 import { Renderer } from "../Renderer";
+import { IPoolElement } from "./IPoolElement";
 import { RenderData } from "./RenderData";
-export declare class SpriteMaskRenderData extends RenderData {
+export declare class SpriteMaskRenderData extends RenderData implements IPoolElement {
     isAdd: boolean;
     verticesData: VertexData2D;
     constructor();
     set(component: Renderer, material: Material, verticesData: VertexData2D): void;
+    dispose(): void;
 }

package/types/RenderPipeline/SpriteRenderData.d.ts

@@ -2,11 +2,13 @@ import { VertexData2D } from "../2d/data/VertexData2D";
 import { Material } from "../material/Material";
 import { Renderer } from "../Renderer";
 import { Texture2D } from "../texture";
+import { IPoolElement } from "./IPoolElement";
 import { RenderData } from "./RenderData";
-export declare class SpriteRenderData extends RenderData {
+export declare class SpriteRenderData extends RenderData implements IPoolElement {
     verticesData: VertexData2D;
     texture: Texture2D;
     dataIndex: number;
     constructor();
     set(component: Renderer, material: Material, verticesData: VertexData2D, texture: Texture2D, dataIndex?: number): void;
+    dispose(): void;
 }

package/types/RenderPipeline/TextRenderData.d.ts

@@ -1,6 +1,8 @@
+import { IPoolElement } from "./IPoolElement";
 import { RenderData } from "./RenderData";
 import { SpriteRenderData } from "./SpriteRenderData";
-export declare class TextRenderData extends RenderData {
+export declare class TextRenderData extends RenderData implements IPoolElement {
     charsData: SpriteRenderData[];
     constructor();
+    dispose(): void;
 }

package/types/Renderer.d.ts

@@ -17,12 +17,11 @@ export declare class Renderer extends Component implements ICustomClone {
     private static _mvInvMatrixProperty;
     private static _normalMatrixProperty;
     private static _rendererLayerProperty;
-    /** ShaderData related to renderer. */
-    readonly shaderData: ShaderData;
     _renderFrameCount: number;
     protected _overrideUpdate: boolean;
     protected _materials: Material[];
     protected _dirtyUpdateFlag: number;
+    private _shaderData;
     private _mvMatrix;
     private _mvpMatrix;
     private _mvInvMatrix;
@@ -31,6 +30,10 @@ export declare class Renderer extends Component implements ICustomClone {
     private _priority;
     private _receiveShadows;
     protected _rendererLayer: Vector4;
+    /**
+     * ShaderData related to renderer.
+     */
+    get shaderData(): ShaderData;
     /**
      * Whether it is culled in the current frame and does not participate in rendering.
      */

package/types/Scene.d.ts

@@ -18,10 +18,6 @@ export declare class Scene extends EngineObject {
     private static _sunlightDirectionProperty;
     /** Scene name. */
     name: string;
-    /** The background of the scene. */
-    readonly background: Background;
-    /** Scene-related shader data. */
-    readonly shaderData: ShaderData;
     /** If cast shadows. */
     castShadows: boolean;
     /** The resolution of the shadow maps. */
@@ -32,6 +28,8 @@ export declare class Scene extends EngineObject {
     shadowFourCascadeSplits: Vector3;
     /** Max Shadow distance. */
     shadowDistance: number;
+    private _background;
+    private _shaderData;
     private _shadowCascades;
     private _ambientLight;
     private _fogMode;
@@ -40,6 +38,14 @@ export declare class Scene extends EngineObject {
     private _fogEnd;
     private _fogDensity;
     private _fogParams;
+    /**
+     * Scene-related shader data.
+     */
+    get shaderData(): ShaderData;
+    /**
+     * The background of the scene.
+     */
+    get background(): Background;
     /**
      *  Number of cascades to use for directional light shadows.
      */

package/types/graphic/SubMesh.d.ts

@@ -1,8 +1,9 @@
+import { IPoolElement } from "../RenderPipeline/IPoolElement";
 import { MeshTopology } from "./enums/MeshTopology";
 /**
  * Sub-mesh, mainly contains drawing information.
  */
-export declare class SubMesh {
+export declare class SubMesh implements IPoolElement {
     /** Start drawing offset. */
     start: number;
     /** Drawing count. */
@@ -16,4 +17,5 @@ export declare class SubMesh {
      * @param topology - Drawing topology
      */
     constructor(start?: number, count?: number, topology?: MeshTopology);
+    dispose?(): void;
 }

package/types/material/Material.d.ts

@@ -10,8 +10,11 @@ import { RenderState } from "../shader/state/RenderState";
 export declare class Material extends ReferResource implements IClone {
     /** Name. */
     name: string;
-    /** Shader data. */
-    readonly shaderData: ShaderData;
+    private _shaderData;
+    /**
+     *  Shader data.
+     */
+    get shaderData(): ShaderData;
     /**
      * Shader used by the material.
      */
@@ -41,4 +44,8 @@ export declare class Material extends ReferResource implements IClone {
      */
     cloneTo(target: Material): void;
     _addReferCount(value: number): void;
+    /**
+     * @override
+     */
+    protected _onDestroy(): void;
 }

package/types/texture/Texture.d.ts

@@ -2,6 +2,7 @@ import { GraphicsResource } from "../asset/GraphicsResource";
 import { TextureDepthCompareFunction } from "./enums/TextureDepthCompareFunction";
 import { TextureFilterMode } from "./enums/TextureFilterMode";
 import { TextureFormat } from "./enums/TextureFormat";
+import { TextureUsage } from "./enums/TextureUsage";
 import { TextureWrapMode } from "./enums/TextureWrapMode";
 /**
  * The base class of texture, contains some common functions of texture-related classes.
@@ -11,6 +12,7 @@ export declare abstract class Texture extends GraphicsResource {
     protected _format: TextureFormat;
     protected _width: number;
     protected _height: number;
+    protected _usage: TextureUsage;
     protected _mipmapCount: number;
     private _wrapModeU;
     private _wrapModeV;
@@ -30,6 +32,10 @@ export declare abstract class Texture extends GraphicsResource {
      * The height of the texture.
      */
     get height(): number;
+    /**
+     * The usage of the texture.
+     */
+    get usage(): TextureUsage;
     /**
      * Wrapping mode for texture coordinate S.
      */

package/types/texture/Texture2D.d.ts

@@ -1,5 +1,6 @@
 import { Engine } from "../Engine";
 import { TextureFormat } from "./enums/TextureFormat";
+import { TextureUsage } from "./enums/TextureUsage";
 import { Texture } from "./Texture";
 /**
  * Two-dimensional texture.
@@ -12,8 +13,9 @@ export declare class Texture2D extends Texture {
      * @param height - Texture height
      * @param format - Texture format. default  `TextureFormat.R8G8B8A8`
      * @param mipmap - Whether to use multi-level texture
+     * @param usage - Texture usage
      */
-    constructor(engine: Engine, width: number, height: number, format?: TextureFormat, mipmap?: boolean);
+    constructor(engine: Engine, width: number, height: number, format?: TextureFormat, mipmap?: boolean, usage?: TextureUsage);
     /**
      * Setting pixels data through color buffer data, designated area and texture mipmapping level,it's also applicable to compressed formats.
      * @remarks If it is the WebGL1.0 platform and the texture format is compressed, the first upload must be filled with textures.

package/types/texture/enums/TextureUsage.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Texture usage.
+ */
+export declare enum TextureUsage {
+    /** The content of the texture is intended to be specified once.  */
+    Static = 0,
+    /** The content of the texture is intended to be updated frequently, with better performance. */
+    Dynamic = 1
+}

package/types/texture/index.d.ts

@@ -3,6 +3,7 @@ export { TextureCubeFace } from "./enums/TextureCubeFace";
 export { TextureDepthCompareFunction } from "./enums/TextureDepthCompareFunction";
 export { TextureFilterMode } from "./enums/TextureFilterMode";
 export { TextureFormat } from "./enums/TextureFormat";
+export { TextureUsage } from "./enums/TextureUsage";
 export { TextureWrapMode } from "./enums/TextureWrapMode";
 export { RenderTarget } from "./RenderTarget";
 export { Texture } from "./Texture";