@galacean/engine-core 1.3.0-alpha.2 → 1.3.0-beta.10

package/package.json

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

package/types/2d/assembler/IAssembler.d.ts

@@ -0,0 +1 @@
+export {};

package/types/2d/data/VertexData2D.d.ts

@@ -0,0 +1 @@
+export {};

package/types/2d/text/CharRenderData.d.ts

@@ -0,0 +1 @@
+export {};

package/types/2d/text/CharRenderDataPool.d.ts

@@ -0,0 +1 @@
+export {};

package/types/Entity.d.ts

@@ -58,9 +58,10 @@ export declare class Entity extends EngineObject {
     /**
      * Add component based on the component type.
      * @param type - The type of the component
+     * @param args - The arguments of the component
      * @returns	The component which has been added
      */
-    addComponent<T extends Component>(type: new (entity: Entity) => T): T;
+    addComponent<T extends new (entity: Entity, ...args: any[]) => Component>(type: T, ...args: ComponentArguments<T>): InstanceType<T>;
     /**
      * Get component which match the type.
      * @param type - The type of the component
@@ -152,3 +153,5 @@ export declare class Entity extends EngineObject {
      */
     getInvModelMatrix(): Matrix;
 }
+type ComponentArguments<T extends new (entity: Entity, ...args: any[]) => Component> = T extends new (entity: Entity, ...args: infer P) => Component ? P : never;
+export {};

package/types/RenderPipeline/Basic2DBatcher.d.ts

@@ -0,0 +1,19 @@
+import { Camera } from "../Camera";
+import { Engine } from "../Engine";
+import { ShaderTagKey } from "../shader/ShaderTagKey";
+import { RenderElement } from "./RenderElement";
+export declare abstract class Basic2DBatcher {
+    protected static _disableBatchTag: ShaderTagKey;
+    /** The maximum number of vertex. */
+    static MAX_VERTEX_COUNT: number;
+    static _canUploadSameBuffer: boolean;
+    constructor(engine: Engine);
+    drawElement(element: RenderElement, camera: Camera): void;
+    flush(camera: Camera): void;
+    clear(): void;
+    destroy(): void;
+    private _drawSubElement;
+    private _createMesh;
+    private _updateData;
+    private _getSubMeshFromPool;
+}

package/types/RenderPipeline/ClassPool.d.ts

@@ -0,0 +1,19 @@
+import { IPoolElement } from "./IPoolElement";
+/**
+ * Class pool utils.
+ */
+export declare class ClassPool<T extends IPoolElement> {
+    private _elementPoolIndex;
+    private _elementPool;
+    private _type;
+    constructor(type: new () => T);
+    /**
+     * Get element from pool.
+     */
+    getFromPool(): 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/RenderData.d.ts

@@ -0,0 +1,14 @@
+import { SubMesh } from "../graphic";
+import { Primitive } from "../graphic/Primitive";
+import { Material } from "../material";
+import { Renderer } from "../Renderer";
+import { IPoolElement } from "./IPoolElement";
+export declare class RenderData implements IPoolElement {
+    component: Renderer;
+    material: Material;
+    primitive: Primitive;
+    subPrimitive: SubMesh;
+    multiRenderData: boolean;
+    setX(component: Renderer, material: Material, primitive: Primitive, subPrimitive: SubMesh): void;
+    dispose(): void;
+}

package/types/RenderPipeline/SpriteBatcher.d.ts

@@ -0,0 +1 @@
+export {};

package/types/RenderPipeline/SpriteMaskBatcher.d.ts

@@ -0,0 +1,11 @@
+import { Camera } from "../Camera";
+import { VertexElement } from "../graphic/VertexElement";
+import { Basic2DBatcher } from "./Basic2DBatcher";
+import { RenderElement } from "./RenderElement";
+import { SpriteMaskRenderData } from "./SpriteMaskRenderData";
+export declare class SpriteMaskBatcher extends Basic2DBatcher {
+    createVertexElements(vertexElements: VertexElement[]): number;
+    canBatch(preElement: RenderElement, curElement: RenderElement): boolean;
+    updateVertices(element: SpriteMaskRenderData, vertices: Float32Array, vertexIndex: number): number;
+    drawBatches(camera: Camera): void;
+}

package/types/RenderPipeline/SpriteMaskManager.d.ts

@@ -0,0 +1 @@
+export {};

package/types/RenderPipeline/SpriteMaskRenderData.d.ts

@@ -0,0 +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 implements IPoolElement {
+    isAdd: boolean;
+    verticesData: VertexData2D;
+    constructor();
+    set(component: Renderer, material: Material, verticesData: VertexData2D): void;
+    dispose(): void;
+}

package/types/RenderPipeline/SpriteRenderData.d.ts

@@ -0,0 +1,14 @@
+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 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

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

package/types/Renderer.d.ts

@@ -1,6 +1,7 @@
 import { BoundingBox, Matrix, Vector4 } from "@galacean/engine-math";
 import { Component } from "./Component";
 import { RenderContext } from "./RenderPipeline/RenderContext";
+import { Transform } from "./Transform";
 import { IComponentCustomClone } from "./clone/ComponentCloner";
 import { Material } from "./material";
 import { ShaderData } from "./shader/ShaderData";
@@ -23,6 +24,7 @@ export declare class Renderer extends Component implements IComponentCustomClone
     protected _materials: Material[];
     protected _dirtyUpdateFlag: number;
     protected _rendererLayer: Vector4;
+    protected _transform: Transform;
     private _shaderData;
     private _mvMatrix;
     private _mvpMatrix;
@@ -111,7 +113,10 @@ export declare class Renderer extends Component implements IComponentCustomClone
      */
     setMaterials(materials: Material[]): void;
     update(deltaTime: number): void;
-    protected _updateRendererShaderData(context: RenderContext): void;
+    /**
+     * Update once per frame per renderer, not influenced by batched.
+     */
+    protected _update(context: RenderContext): void;
     protected _updateWorldViewRelatedShaderData(context: RenderContext, worldMatrix: Matrix, batched: boolean): void;
     protected _updateProjectionRelatedShaderData(context: RenderContext, worldMatrix: Matrix, batched: boolean): void;
     private _setMaterial;

package/types/animation/Animator.d.ts

@@ -2,7 +2,7 @@ import { BoolUpdateFlag } from "../BoolUpdateFlag";
 import { Component } from "../Component";
 import { AnimatorController } from "./AnimatorController";
 import { AnimatorControllerLayer } from "./AnimatorControllerLayer";
-import { AnimatorControllerParameter } from "./AnimatorControllerParameter";
+import { AnimatorControllerParameter, AnimatorControllerParameterValue } from "./AnimatorControllerParameter";
 import { AnimatorState } from "./AnimatorState";
 import { AnimatorCullingMode } from "./enums/AnimatorCullingMode";
 /**
@@ -19,6 +19,7 @@ export declare class Animator extends Component {
     private _animatorLayersData;
     private _curveOwnerPool;
     private _animationEventHandlerPool;
+    private _parametersValueMap;
     private _tempAnimatorStateInfo;
     private _controlledRenderers;
     /**
@@ -75,6 +76,18 @@ export declare class Animator extends Component {
      * @param name - The name of the parameter
      */
     getParameter(name: string): AnimatorControllerParameter;
+    /**
+     * Get the value of the given parameter.
+     * @param name - The name of the parameter
+     * @param value - The value of the parameter
+     */
+    getParameterValue(name: string): AnimatorControllerParameterValue;
+    /**
+     * Set the value of the given parameter.
+     * @param name - The name of the parameter
+     * @param value - The value of the parameter
+     */
+    setParameterValue(name: string, value: AnimatorControllerParameterValue): void;
     private _getAnimatorStateInfo;
     private _getAnimatorStateData;
     private _saveAnimatorStateData;
@@ -87,7 +100,6 @@ export declare class Animator extends Component {
     private _prepareSrcCrossData;
     private _prepareDestCrossData;
     private _getAnimatorLayerData;
-    private _updateLayer;
     private _updateState;
     private _updatePlayingState;
     private _evaluatePlayingState;
@@ -115,4 +127,5 @@ export declare class Animator extends Component {
     private _callAnimatorScriptOnExit;
     private _checkAnyAndEntryState;
     private _checkRevertOwner;
+    private _fireAnimationEventsAndCallScripts;
 }

package/types/animation/AnimatorCondition.d.ts

@@ -1,4 +1,4 @@
-import { AnimatorControllerParameterValueType } from "./AnimatorControllerParameter";
+import { AnimatorControllerParameterValue } from "./AnimatorControllerParameter";
 import { AnimatorConditionMode } from "./enums/AnimatorConditionMode";
 /**
  * Condition that is used to determine if a transition must be taken.
@@ -9,5 +9,5 @@ export declare class AnimatorCondition {
     /** The name of the parameter used in the condition. */
     parameterName: string;
     /** The AnimatorParameter's threshold value for the condition to be true. */
-    threshold?: AnimatorControllerParameterValueType;
+    threshold?: AnimatorControllerParameterValue;
 }

package/types/animation/AnimatorController.d.ts

@@ -1,9 +1,11 @@
-import { AnimatorControllerParameter, AnimatorControllerParameterValueType } from "./AnimatorControllerParameter";
+import { AnimatorControllerParameter, AnimatorControllerParameterValue } from "./AnimatorControllerParameter";
 import { AnimatorControllerLayer } from "./AnimatorControllerLayer";
+import { ReferResource } from "../asset/ReferResource";
+import { Engine } from "../Engine";
 /**
  * Store the data for Animator playback.
  */
-export declare class AnimatorController {
+export declare class AnimatorController extends ReferResource {
     private _updateFlagManager;
     /**
      * The layers in the controller.
@@ -14,32 +16,30 @@ export declare class AnimatorController {
      */
     get parameters(): Readonly<AnimatorControllerParameter[]>;
     /**
-     * Add a parameter to the controller.
-     * @param name - The name of the parameter
-     * @param value - The value of the parameter
+     * Create an AnimatorController.
+     * @param engine - Engine to which the animatorController belongs
+     */
+    constructor(engine: Engine);
+    /**
+     * @deprecated
      */
-    addParameter(name: string, value?: AnimatorControllerParameterValueType): AnimatorControllerParameter;
+    constructor();
     /**
      * Add a parameter to the controller.
-     * @param parameter - The parameter
+     * @param name - The name of the parameter
+     * @param defaultValue - The default value of the parameter
      */
-    addParameter(parameter: AnimatorControllerParameter): AnimatorControllerParameter;
+    addParameter(name: string, defaultValue?: AnimatorControllerParameterValue): AnimatorControllerParameter;
     /**
-     * Remove a parameter from the controller.
-     * @param parameter - The parameter
+     * Remove a parameter from the controller by name.
+     * @param name - The parameter name
      */
-    removeParameter(parameter: AnimatorControllerParameter): void;
+    removeParameter(name: string): void;
     /**
      * Get the parameter by name.
      * @param name - The name of the parameter
      */
     getParameter(name: string): AnimatorControllerParameter;
-    /**
-     * Set the value of the given parameter.
-     * @param name - The name of the parameter
-     * @param value - The value of the parameter
-     */
-    setParameterValue(name: string, value: AnimatorControllerParameterValueType): void;
     /**
      * Get the layer by name.
      * @param name - The layer's name.

package/types/animation/AnimatorControllerParameter.d.ts

@@ -1,10 +1,14 @@
-export type AnimatorControllerParameterValueType = number | string | boolean;
+export type AnimatorControllerParameterValue = number | string | boolean;
 /**
  * Used to communicate between scripting and the controller, parameters can be set in scripting and used by the controller.
  */
 export declare class AnimatorControllerParameter {
-    /** The name of the parameter. */
-    name: string;
-    /** The value of the parameter. */
-    value: AnimatorControllerParameterValueType;
+    /** The default value of the parameter. */
+    defaultValue: AnimatorControllerParameterValue;
+    private _name;
+    /**
+     * The name of the parameter.
+     */
+    get name(): string;
+    set name(name: string);
 }

package/types/animation/AnimatorStateTransition.d.ts

@@ -1,4 +1,4 @@
-import { AnimatorControllerParameterValueType } from "./AnimatorControllerParameter";
+import { AnimatorControllerParameterValue } from "./AnimatorControllerParameter";
 import { AnimatorConditionMode } from "./enums/AnimatorConditionMode";
 import { AnimatorCondition } from "./AnimatorCondition";
 import { AnimatorState } from "./AnimatorState";
@@ -37,7 +37,7 @@ export declare class AnimatorStateTransition {
      * @param parameterName - The name of the parameter
      * @param threshold - The threshold value of the condition
      */
-    addCondition(mode: AnimatorConditionMode, parameterName: string, threshold?: AnimatorControllerParameterValueType): AnimatorCondition;
+    addCondition(mode: AnimatorConditionMode, parameterName: string, threshold?: AnimatorControllerParameterValue): AnimatorCondition;
     /**
      * Add a condition to a transition.
      * @param animatorCondition - The condition to add

package/types/animation/AnimatorTransition.d.ts

@@ -0,0 +1,14 @@
+import { AnimatorState } from "./AnimatorState";
+/**
+ * Transitions define when and how the state machine switch from on state to another. AnimatorTransition always originate from a StateMachine or a StateMachine entry.
+ */
+export declare class AnimatorStateTransition {
+    /** The duration of the transition. This is represented in normalized time. */
+    duration: number;
+    /** The time at which the destination state will start. This is represented in normalized time. */
+    offset: number;
+    /** ExitTime represents the exact time at which the transition can take effect. This is represented in normalized time. */
+    exitTime: number;
+    /** The destination state of the transition. */
+    destinationState: AnimatorState;
+}

package/types/animation/index.d.ts

@@ -20,3 +20,6 @@ export { WrapMode } from "./enums/WrapMode";
 export * from "./Keyframe";
 export * from "./AnimatorLayerMask";
 export { StateMachineScript } from "./StateMachineScript";
+export { AnimatorCondition } from "./AnimatorCondition";
+export * from "./AnimatorControllerParameter";
+export { LayerPathMask } from "./LayerPathMask";

package/types/asset/ResourceManager.d.ts

@@ -102,11 +102,13 @@ export declare class ResourceManager {
     addContentRestorer<T extends EngineObject>(restorer: ContentRestorer<T>): void;
     private _assignDefaultOptions;
     private _loadSingleItem;
-    private _pushSubAssetPromiseCallback;
+    private _loadMainAsset;
+    private _createSubAssetPromiseCallback;
     private _gc;
     private _getResolveResource;
     private _parseURL;
     private _parseQueryPath;
+    private _releaseSubAssetPromiseCallback;
 }
 /**
  * Declare ResourceLoader's decorator.

package/types/lighting/Light.d.ts

@@ -21,11 +21,13 @@ export declare abstract class Light extends Component {
     shadowNormalBias: number;
     /** Near plane value to use for shadow frustums. */
     shadowNearPlane: number;
-    /** Shadow intensity, the larger the value, the clearer and darker the shadow. */
-    shadowStrength: number;
+    private _shadowStrength;
     private _color;
     private _viewMat;
     private _inverseViewMat;
+    /** Shadow intensity, the larger the value, the clearer and darker the shadow, range [0,1]. */
+    get shadowStrength(): number;
+    set shadowStrength(value: number);
     /**
      * Light Color.
      */

package/types/mesh/SkinnedMeshRenderer.d.ts

@@ -32,7 +32,7 @@ export declare class SkinnedMeshRenderer extends MeshRenderer {
      */
     get localBounds(): BoundingBox;
     set localBounds(value: BoundingBox);
-    protected _updateRendererShaderData(context: RenderContext): void;
+    protected _update(context: RenderContext): void;
     private _checkBlendShapeWeightLength;
     private _onLocalBoundsChanged;
     private _onSkinUpdated;

package/types/particle/ParticleRenderer.d.ts

@@ -41,7 +41,7 @@ export declare class ParticleRenderer extends Renderer {
     get mesh(): ModelMesh;
     set mesh(value: ModelMesh);
     protected _updateBounds(worldBounds: BoundingBox): void;
-    protected _updateRendererShaderData(context: RenderContext): void;
+    protected _update(context: RenderContext): void;
     protected _render(context: RenderContext): void;
     protected _onDestroy(): void;
 }

package/types/utils/SafeLoopArray.d.ts

@@ -22,6 +22,11 @@ export declare class SafeLoopArray<T> {
      * @param index - The index of the array
      */
     removeByIndex(index: number): void;
+    /**
+     * Remove item from array that pass the specified comparison function.
+     * @param filter - The comparison function
+     */
+    findAndRemove(filter: (value: T) => boolean): void;
     /**
      * The index of the item.
      * @param item - The item which want to get the index

package/types/utils/index.d.ts

@@ -1,3 +1,4 @@
 export { ClearableObjectPool } from "./ClearableObjectPool";
 export type { IPoolElement } from "./ObjectPool";
 export { ReturnableObjectPool } from "./ReturnableObjectPool";
+export { SafeLoopArray } from "./SafeLoopArray";