@galacean/engine-core 1.1.0-beta.3 → 1.1.0-beta.4

package/package.json

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

package/types/RenderPipeline/MeshRenderElement.d.ts

@@ -4,14 +4,16 @@ import { Material } from "../material/Material";
 import { Renderer } from "../Renderer";
 import { ShaderPass } from "../shader/ShaderPass";
 import { RenderState } from "../shader/state/RenderState";
+import { IPoolElement } from "./IPoolElement";
 import { RenderElement } from "./RenderElement";
 /**
  * Render element.
  */
-export declare class MeshRenderElement extends RenderElement {
+export declare class MeshRenderElement extends RenderElement implements IPoolElement {
     /** Mesh. */
     mesh: Mesh;
     /** Sub mesh. */
     subMesh: SubMesh;
     setValue(component: Renderer, mesh: Mesh, subMesh: SubMesh, material: Material, renderState: RenderState, shaderPass: ShaderPass): void;
+    dispose(): void;
 }

package/types/RenderPipeline/SpriteElement.d.ts

@@ -4,10 +4,12 @@ import { Renderer } from "../Renderer";
 import { ShaderPass } from "../shader";
 import { RenderState } from "../shader/state/RenderState";
 import { Texture2D } from "../texture";
+import { IPoolElement } from "./IPoolElement";
 import { RenderElement } from "./RenderElement";
-export declare class SpriteElement extends RenderElement {
+export declare class SpriteElement extends RenderElement implements IPoolElement {
     renderData: RenderData2D;
     texture: Texture2D;
     constructor();
     setValue(component: Renderer, renderDate: RenderData2D, material: Material, texture: Texture2D, renderState: RenderState, shaderPass: ShaderPass): void;
+    dispose(): void;
 }

package/types/RenderPipeline/SpriteMaskElement.d.ts

@@ -1,10 +1,12 @@
 import { RenderData2D } from "../2d/data/RenderData2D";
 import { Material } from "../material/Material";
 import { Renderer } from "../Renderer";
+import { IPoolElement } from "./IPoolElement";
 import { RenderElement } from "./RenderElement";
-export declare class SpriteMaskElement extends RenderElement {
+export declare class SpriteMaskElement extends RenderElement implements IPoolElement {
     renderData: RenderData2D;
     isAdd: boolean;
     constructor();
     setValue(component: Renderer, renderData: RenderData2D, material: Material): void;
+    dispose(): void;
 }

package/types/RenderPipeline/TextRenderElement.d.ts

@@ -1,6 +1,8 @@
+import { IPoolElement } from "./IPoolElement";
 import { RenderElement } from "./RenderElement";
 import { SpriteElement } from "./SpriteElement";
-export declare class TextRenderElement extends RenderElement {
+export declare class TextRenderElement extends RenderElement implements IPoolElement {
     charElements: SpriteElement[];
     constructor();
+    dispose(): void;
 }

package/types/lighting/DirectLight.d.ts

@@ -7,7 +7,6 @@ export declare class DirectLight extends Light {
     private static _cullingMaskProperty;
     private static _colorProperty;
     private static _directionProperty;
-    private static _combinedData;
     private _reverseDirection;
     /**
      * Get direction.
@@ -18,3 +17,11 @@ export declare class DirectLight extends Light {
      */
     get reverseDirection(): Vector3;
 }
+/**
+ * Shader properties data of direct lights in the scene.
+ */
+export interface IDirectLightShaderData {
+    cullingMask: Int32Array;
+    color: Float32Array;
+    direction: Float32Array;
+}

package/types/lighting/Light.d.ts

@@ -6,10 +6,6 @@ import { ShadowType } from "../shadow";
  * Light base class.
  */
 export declare abstract class Light extends Component {
-    /**
-     * Each type of light source is at most 10, beyond which it will not take effect.
-     * */
-    protected static _maxLight: number;
     /** Light Intensity */
     intensity: number;
     /**

package/types/lighting/LightManager.d.ts

@@ -2,5 +2,12 @@
  * Light manager.
  */
 export declare class LightManager {
+    /**
+     * Each type of light source is at most 10, beyond which it will not take effect.
+     * */
+    private static _maxLight;
+    private _directData;
+    private _pointData;
+    private _spotData;
     private _getSunLightIndex;
 }

package/types/lighting/PointLight.d.ts

@@ -8,7 +8,6 @@ export declare class PointLight extends Light {
     private static _colorProperty;
     private static _positionProperty;
     private static _distanceProperty;
-    private static _combinedData;
     /** Defines a distance cutoff at which the light's intensity must be considered zero. */
     distance: number;
     /**
@@ -16,3 +15,12 @@ export declare class PointLight extends Light {
      */
     get position(): Vector3;
 }
+/**
+ * Shader properties data of point lights in the scene.
+ */
+export interface IPointLightShaderData {
+    cullingMask: Int32Array;
+    color: Float32Array;
+    position: Float32Array;
+    distance: Float32Array;
+}

package/types/lighting/SpotLight.d.ts

@@ -11,7 +11,6 @@ export declare class SpotLight extends Light {
     private static _distanceProperty;
     private static _angleCosProperty;
     private static _penumbraCosProperty;
-    private static _combinedData;
     /** Defines a distance cutoff at which the light's intensity must be considered zero. */
     distance: number;
     /** Angle, in radians, from centre of spotlight where falloff begins. */
@@ -33,3 +32,15 @@ export declare class SpotLight extends Light {
      */
     get reverseDirection(): Vector3;
 }
+/**
+ * Shader properties data of spot lights in the scene.
+ */
+export interface ISpotLightShaderData {
+    cullingMask: Int32Array;
+    color: Float32Array;
+    position: Float32Array;
+    direction: Float32Array;
+    distance: Float32Array;
+    angleCos: Float32Array;
+    penumbraCos: Float32Array;
+}

package/types/particle/modules/MainModule.d.ts

@@ -26,22 +26,19 @@ export declare class MainModule implements ICustomClone {
     startSpeed: ParticleCompositeCurve;
     /** A flag to enable specifying particle size individually for each axis. */
     startSize3D: boolean;
-    /** The initial size of particles when the Particle Generator first spawns them. */
-    startSize: ParticleCompositeCurve;
     /** The initial size of particles along the x-axis when the Particle Generator first spawns them. */
     startSizeX: ParticleCompositeCurve;
     /** The initial size of particles along the y-axis when the Particle Generator first spawns them. */
     startSizeY: ParticleCompositeCurve;
     /** The initial size of particles along the z-axis when the Particle Generator first spawns them. */
     startSizeZ: ParticleCompositeCurve;
-    /** A flag to enable 3D particle rotation. */
+    /** A flag to enable 3D particle rotation, when disabled, only `startRotationZ` is used. */
     startRotation3D: boolean;
-    /** The initial rotation of particles when the Particle Generator first spawns them. */
-    startRotation: ParticleCompositeCurve;
     /** The initial rotation of particles around the x-axis when emitted.*/
     startRotationX: ParticleCompositeCurve;
     /** The initial rotation of particles around the y-axis when emitted. */
     startRotationY: ParticleCompositeCurve;
+    /** The initial rotation of particles around the z-axis when emitted. */
     startRotationZ: ParticleCompositeCurve;
     /** Makes some particles spin in the opposite direction. */
     flipRotation: number;
@@ -65,4 +62,9 @@ export declare class MainModule implements ICustomClone {
      */
     get maxParticles(): number;
     set maxParticles(value: number);
+    /**
+     * The initial size of particles when the Particle Generator first spawns them.
+     */
+    get startSize(): ParticleCompositeCurve;
+    set startSize(value: ParticleCompositeCurve);
 }

package/types/particle/modules/RotationOverLifetimeModule.d.ts

@@ -18,7 +18,7 @@ export declare class RotationOverLifetimeModule extends ParticleGeneratorModule
     static readonly _maxCurveXProperty: ShaderProperty;
     static readonly _maxCurveYProperty: ShaderProperty;
     static readonly _maxCurveZProperty: ShaderProperty;
-    /** Specifies whether the rotation is separate on each axis, when disabled only z axis is used. */
+    /** Specifies whether the rotation is separate on each axis, when disabled, only `rotationZ` is used. */
     separateAxes: boolean;
     /** Rotation over lifetime for z axis. */
     rotationX: ParticleCompositeCurve;

package/types/particle/modules/TextureSheetAnimationModule.d.ts

@@ -26,10 +26,6 @@ export declare class TextureSheetAnimationModule extends ParticleGeneratorModule
      * */
     get tiling(): Vector2;
     set tiling(value: Vector2);
-    /**
-     * @inheritDoc
-     */
-    cloneTo(dest: TextureSheetAnimationModule): void;
 }
 /**
  * Texture sheet animation type.

package/types/physics/PhysicsManager.d.ts

@@ -1,3 +1,4 @@
+import { IPhysics } from "@galacean/engine-design";
 import { Ray, Vector3 } from "@galacean/engine-math";
 import { Engine } from "../Engine";
 import { Layer } from "../Layer";
@@ -6,10 +7,8 @@ import { HitResult } from "./HitResult";
  * A physics manager is a collection of colliders and constraints which can interact.
  */
 export declare class PhysicsManager {
-    private static _collision;
     private _engine;
     private _restTime;
-    private _fixedTimeStep;
     private _colliders;
     private _gravity;
     private _nativePhysicsManager;
@@ -20,15 +19,33 @@ export declare class PhysicsManager {
     private _onTriggerEnter;
     private _onTriggerExit;
     private _onTriggerStay;
+    /** The fixed time step in seconds at which physics are performed. */
+    fixedTimeStep: number;
+    /**
+     * The max allowed time step in seconds one frame.
+     *
+     * @remarks
+     * When the frame rate is low or stutter occurs, the maximum execution time of physics will not exceed this value.
+     * So physics will slow down a bit when performance hitch occurs.
+     */
+    maxAllowedTimeStep: number;
     /**
      * The gravity of physics scene.
      */
     get gravity(): Vector3;
     set gravity(value: Vector3);
-    /** The fixed time step in seconds at which physics are performed. */
-    get fixedTimeStep(): number;
-    set fixedTimeStep(value: number);
+    /**
+     * @deprecated
+     * Please use `maxAllowedTimeStep` instead.
+     */
+    get maxSumTimeStep(): number;
+    set maxSumTimeStep(value: number);
     constructor(engine: Engine);
+    /**
+     * initialize PhysicsManager.
+     * @param physics - Physics Engine
+     */
+    initialize(physics: IPhysics): void;
     /**
      * Casts a ray through the Scene and returns the first hit.
      * @param ray - The ray