@galacean/engine-core 1.2.0-beta.6 → 1.3.0-alpha.1

package/types/animation/AnimatorState.d.ts

@@ -1,5 +1,5 @@
 import { AnimationClip } from "./AnimationClip";
-import { AnimatorStateTransition } from "./AnimatorTransition";
+import { AnimatorStateTransition } from "./AnimatorStateTransition";
 import { WrapMode } from "./enums/WrapMode";
 import { StateMachineScript } from "./StateMachineScript";
 /**
@@ -25,12 +25,12 @@ export declare class AnimatorState {
     get clip(): AnimationClip;
     set clip(clip: AnimationClip);
     /**
-     * The start time of the clip, the range is 0 to 1, default is 0.
+     * The normalized start time of the clip, the range is 0 to 1, default is 0.
      */
     get clipStartTime(): number;
     set clipStartTime(time: number);
     /**
-     * The end time of the clip, the range is 0 to 1, default is 1.
+     * The normalized end time of the clip, the range is 0 to 1, default is 1.
      */
     get clipEndTime(): number;
     set clipEndTime(time: number);
@@ -39,10 +39,20 @@ export declare class AnimatorState {
      */
     constructor(name: string);
     /**
-     * Add an outgoing transition to the destination state.
+     * Add an outgoing transition.
      * @param transition - The transition
      */
-    addTransition(transition: AnimatorStateTransition): void;
+    addTransition(transition: AnimatorStateTransition): AnimatorStateTransition;
+    /**
+     * Add an outgoing transition to the destination state.
+     * @param animatorState - The destination state
+     */
+    addTransition(animatorState: AnimatorState): AnimatorStateTransition;
+    /**
+     * Add an outgoing transition to exit of the stateMachine.
+     * @param exitTime - The time at which the transition can take effect. This is represented in normalized time.
+     */
+    addExitTransition(exitTime?: number): AnimatorStateTransition;
     /**
      * Remove a transition from the state.
      * @param transition - The transition

package/types/animation/AnimatorStateMachine.d.ts

@@ -1,4 +1,5 @@
 import { AnimatorState } from "./AnimatorState";
+import { AnimatorStateTransition } from "./AnimatorStateTransition";
 export interface AnimatorStateMap {
     [key: string]: AnimatorState;
 }
@@ -13,6 +14,17 @@ export declare class AnimatorStateMachine {
      * @remarks When the Animator's AnimatorController changed or the Animator's onEnable be triggered.
      */
     defaultState: AnimatorState;
+    private _entryTransitions;
+    private _anyStateTransitions;
+    private _statesMap;
+    /**
+     * The list of entry transitions in the state machine.
+     */
+    get entryTransitions(): Readonly<AnimatorStateTransition[]>;
+    /**
+     * The list of AnyState transitions.
+     */
+    get anyStateTransitions(): Readonly<AnimatorStateTransition[]>;
     /**
      * Add a state to the state machine.
      * @param name - The name of the new state
@@ -34,4 +46,36 @@ export declare class AnimatorStateMachine {
      * @returns Unique name.
      */
     makeUniqueStateName(name: string): string;
+    /**
+     * Add an entry transition.
+     * @param transition - The transition
+     */
+    addEntryStateTransition(transition: AnimatorStateTransition): AnimatorStateTransition;
+    /**
+     * Add an entry transition to the destination state.
+     * @param animatorState - The destination state
+     */
+    addEntryStateTransition(animatorState: AnimatorState): AnimatorStateTransition;
+    /**
+     * Remove an entry transition.
+     * @param transition - The transition
+     */
+    removeEntryStateTransition(transition: AnimatorStateTransition): void;
+    /**
+     * Add an any transition.
+     * @param transition - The transition
+     */
+    addAnyStateTransition(transition: AnimatorStateTransition): AnimatorStateTransition;
+    /**
+     * Add an any transition to the destination state.
+     * @param animatorState - The destination state
+     */
+    addAnyStateTransition(animatorState: AnimatorState): AnimatorStateTransition;
+    /**
+     * Remove an any transition.
+     * @param transition - The transition
+     */
+    removeAnyStateTransition(transition: AnimatorStateTransition): void;
+    private _addTransition;
+    private _removeTransition;
 }

package/types/animation/AnimatorStateTransition.d.ts

@@ -0,0 +1,51 @@
+import { AnimatorControllerParameterValueType } from "./AnimatorControllerParameter";
+import { AnimatorConditionMode } from "./enums/AnimatorConditionMode";
+import { AnimatorCondition } from "./AnimatorCondition";
+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;
+    /** Mutes the transition. The transition will never occur. */
+    mute: boolean;
+    private _conditions;
+    private _solo;
+    /**
+     * Is the transition destination the exit of the current state machine.
+     */
+    get isExit(): Readonly<boolean>;
+    /**
+     * Mutes all other transitions in the source state.
+     */
+    get solo(): boolean;
+    set solo(value: boolean);
+    /**
+     * The conditions in the transition.
+     */
+    get conditions(): Readonly<AnimatorCondition[]>;
+    /**
+     * Add a condition to a transition.
+     * @param mode - The AnimatorCondition mode of the condition
+     * @param parameterName - The name of the parameter
+     * @param threshold - The threshold value of the condition
+     */
+    addCondition(mode: AnimatorConditionMode, parameterName: string, threshold?: AnimatorControllerParameterValueType): AnimatorCondition;
+    /**
+     * Add a condition to a transition.
+     * @param animatorCondition - The condition to add
+     */
+    addCondition(animatorCondition: AnimatorCondition): AnimatorCondition;
+    /**
+     * Remove a condition from the transition.
+     * @param condition - The condition to remove
+     */
+    removeCondition(condition: AnimatorCondition): void;
+}

package/types/animation/enums/AnimatorConditionMode.d.ts

@@ -1,8 +1,17 @@
+/**
+ * The mode of the animator condition.
+ */
 export declare enum AnimatorConditionMode {
+    /** The condition is true when the parameter value is true. */
     If = 0,
+    /** The condition is true when the parameter value is false. */
     IfNot = 1,
+    /** The condition is true when the parameter value is greater than the threshold. */
     Greater = 2,
+    /** The condition is true when the parameter value is less than the threshold. */
     Less = 3,
+    /** The condition is true when the parameter value is equal to the threshold. */
     Equals = 4,
+    /** The condition is true when the parameter value is not equal to the threshold. */
     NotEquals = 5
 }

package/types/animation/index.d.ts

@@ -11,7 +11,7 @@ export { AnimatorController } from "./AnimatorController";
 export { AnimatorControllerLayer } from "./AnimatorControllerLayer";
 export { AnimatorState } from "./AnimatorState";
 export { AnimatorStateMachine } from "./AnimatorStateMachine";
-export { AnimatorStateTransition } from "./AnimatorTransition";
+export { AnimatorStateTransition } from "./AnimatorStateTransition";
 export { AnimatorConditionMode } from "./enums/AnimatorConditionMode";
 export { AnimatorLayerBlendingMode } from "./enums/AnimatorLayerBlendingMode";
 export { AnimatorCullingMode } from "./enums/AnimatorCullingMode";

package/types/asset/AssetType.d.ts

@@ -30,6 +30,8 @@ export declare enum AssetType {
     /** AnimatorController. */
     AnimatorController = "AnimatorController",
     /** Prefab.*/
+    Prefab = "Prefab",
+    /** GLTF.*/
     GLTF = "GLTF",
     /** Compress Texture. */
     KTX = "KTX",

package/types/graphic/SubMesh.d.ts

@@ -1,21 +1,8 @@
-import { IPoolElement } from "../RenderPipeline/IPoolElement";
-import { MeshTopology } from "./enums/MeshTopology";
+import { IPoolElement } from "../utils/ObjectPool";
+import { SubPrimitive } from "./SubPrimitive";
 /**
  * Sub-mesh, mainly contains drawing information.
  */
-export declare class SubMesh implements IPoolElement {
-    /** Start drawing offset. */
-    start: number;
-    /** Drawing count. */
-    count: number;
-    /** Drawing topology. */
-    topology: MeshTopology;
-    /**
-     * Create a sub-mesh.
-     * @param start - Start drawing offset
-     * @param count - Drawing count
-     * @param topology - Drawing topology
-     */
-    constructor(start?: number, count?: number, topology?: MeshTopology);
+export declare class SubMesh extends SubPrimitive implements IPoolElement {
     dispose?(): void;
 }

package/types/graphic/SubPrimitive.d.ts

@@ -1,4 +1,7 @@
 import { MeshTopology } from "./enums/MeshTopology";
+/**
+ * Sub-primitive, mainly contains drawing information.
+ */
 export declare class SubPrimitive {
     /** Start drawing offset. */
     start: number;
@@ -6,4 +9,11 @@ export declare class SubPrimitive {
     count: number;
     /** Drawing topology. */
     topology: MeshTopology;
+    /**
+     * Create a sub-primitive.
+     * @param start - Start drawing offset
+     * @param count - Drawing count
+     * @param topology - Drawing topology
+     */
+    constructor(start?: number, count?: number, topology?: MeshTopology);
 }

package/types/graphic/index.d.ts

@@ -12,3 +12,4 @@ export { SubMesh } from "./SubMesh";
 export { VertexBufferBinding } from "./VertexBufferBinding";
 export { VertexElement } from "./VertexElement";
 export { Primitive } from "./Primitive";
+export { SubPrimitive } from "./SubPrimitive";

package/types/index.d.ts

@@ -35,6 +35,7 @@ export { Downsampling } from "./enums/Downsampling";
 export { ColorSpace } from "./enums/ColorSpace";
 export { BackgroundTextureFillMode } from "./enums/BackgroundTextureFillMode";
 export { XRManager } from "./xr/XRManager";
+export * from "./utils/index";
 export * from "./input/index";
 export * from "./lighting/index";
 export * from "./shadow/index";
@@ -55,5 +56,5 @@ export * from "./clone/CloneManager";
 export * from "./renderingHardwareInterface/index";
 export * from "./physics/index";
 export * from "./Utils";
-export { Basic2DBatcher } from "./RenderPipeline/Basic2DBatcher";
 export { ShaderMacroCollection } from "./shader/ShaderMacroCollection";
+export * from "./postProcess";

package/types/material/BaseMaterial.d.ts

@@ -27,7 +27,7 @@ export declare class BaseMaterial extends Material {
     get shader(): Shader;
     set shader(value: Shader);
     /**
-     * Whethor transparent of first shader pass render state.
+     * Whether transparent of first shader pass render state.
      */
     get isTransparent(): boolean;
     set isTransparent(value: boolean);

package/types/mesh/SkinnedMeshRenderer.d.ts

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

package/types/particle/ParticleGenerator.d.ts

@@ -10,7 +10,16 @@ import { VelocityOverLifetimeModule } from "./modules/VelocityOverLifetimeModule
  * Particle Generator.
  */
 export declare class ParticleGenerator {
+    private static _tempVector20;
+    private static _tempVector21;
+    private static _tempVector22;
+    private static _tempVector30;
+    private static _tempVector31;
+    private static _tempMat;
+    private static _tempColor0;
+    private static _tempParticleRenderers;
     private static readonly _particleIncreaseCount;
+    private static readonly _transformedBoundsIncreaseCount;
     /** Use auto random seed. */
     useAutoRandomSeed: boolean;
     /** Main module. */
@@ -33,6 +42,10 @@ export declare class ParticleGenerator {
     private _instanceVertexBufferBinding;
     private _instanceVertices;
     private _randomSeed;
+    private _transformedBoundsArray;
+    private _transformedBoundsCount;
+    private _firstActiveTransformedBoundingBox;
+    private _firstFreeTransformedBoundingBox;
     /**
      * Whether the particle generator is contain alive or is still creating particles.
      */
@@ -67,4 +80,11 @@ export declare class ParticleGenerator {
     private _freeRetiredParticles;
     private _addActiveParticlesToVertexBuffer;
     private _addVertexBufferBindingsFilterDuplicate;
+    private _resizeTransformedBoundsArray;
+    private _retireTransformedBounds;
+    private _calculateGeneratorBounds;
+    private _mergeTransformedBounds;
+    private _calculateTransformedBounds;
+    private _addGravityToBounds;
+    private _getExtremeValueFromZero;
 }

package/types/particle/ParticleRenderer.d.ts

@@ -1,4 +1,4 @@
-import { Vector3 } from "@galacean/engine-math";
+import { BoundingBox, Vector3 } from "@galacean/engine-math";
 import { RenderContext } from "../RenderPipeline/RenderContext";
 import { Renderer } from "../Renderer";
 import { ModelMesh } from "../mesh/ModelMesh";
@@ -40,6 +40,8 @@ export declare class ParticleRenderer extends Renderer {
      */
     get mesh(): ModelMesh;
     set mesh(value: ModelMesh);
+    protected _updateBounds(worldBounds: BoundingBox): void;
+    protected _updateRendererShaderData(context: RenderContext): void;
     protected _render(context: RenderContext): void;
     protected _onDestroy(): void;
 }

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

@@ -10,11 +10,15 @@ export declare class EmissionModule extends ParticleGeneratorModule {
     rateOverTime: ParticleCompositeCurve;
     /**  The rate at which the emitter spawns new particles over distance. */
     rateOverDistance: ParticleCompositeCurve;
-    /** The shape of the emitter. */
-    shape: BaseShape;
+    _shape: BaseShape;
     private _bursts;
     private _currentBurstIndex;
     private _burstRand;
+    /**
+     * The shape of the emitter.
+     */
+    get shape(): BaseShape;
+    set shape(value: BaseShape);
     /**
      * Gets the burst array.
      */

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

@@ -21,18 +21,6 @@ export declare class MainModule implements ICustomClone {
     isLoop: boolean;
     /** Start delay in seconds. */
     startDelay: ParticleCompositeCurve;
-    /** The initial lifetime of particles when emitted. */
-    startLifetime: ParticleCompositeCurve;
-    /** The initial speed of particles when the Particle Generator first spawns them. */
-    startSpeed: ParticleCompositeCurve;
-    /** A flag to enable specifying particle size individually for each axis. */
-    startSize3D: boolean;
-    /** 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, when disabled, only `startRotationZ` is used. */
     startRotation3D: boolean;
     /** The initial rotation of particles around the x-axis when emitted.*/
@@ -46,9 +34,6 @@ export declare class MainModule implements ICustomClone {
     /** The mode of start color */
     startColor: ParticleCompositeGradient;
     /** A scale that this Particle Generator applies to gravity, defined by Physics.gravity. */
-    gravityModifier: ParticleCompositeCurve;
-    /** This selects the space in which to simulate particles. It can be either world or local space. */
-    simulationSpace: ParticleSimulationSpace;
     /** Override the default playback speed of the Particle Generator. */
     simulationSpeed: number;
     /** Control how the Particle Generator applies its Transform component to the particles it emits. */
@@ -56,8 +41,56 @@ export declare class MainModule implements ICustomClone {
     /** If set to true, the Particle Generator automatically begins to play on startup. */
     playOnEnabled: boolean;
     readonly _gravityModifierRand: Rand;
+    private _startLifetime;
+    private _startSpeed;
+    private _startSize3D;
+    private _startSizeX;
+    private _startSizeY;
+    private _startSizeZ;
+    private _gravityModifier;
+    private _simulationSpace;
     private _generator;
     private _gravity;
+    /**
+     * The initial lifetime of particles when emitted.
+     */
+    get startLifetime(): ParticleCompositeCurve;
+    set startLifetime(value: ParticleCompositeCurve);
+    /**
+     * The initial speed of particles when the Particle Generator first spawns them.
+     */
+    get startSpeed(): ParticleCompositeCurve;
+    set startSpeed(value: ParticleCompositeCurve);
+    /**
+     * A flag to enable specifying particle size individually for each axis.
+     */
+    get startSize3D(): boolean;
+    set startSize3D(value: boolean);
+    /**
+     * The initial size of particles along the x-axis when the Particle Generator first spawns them.
+     */
+    get startSizeX(): ParticleCompositeCurve;
+    set startSizeX(value: ParticleCompositeCurve);
+    /**
+     * The initial size of particles along the y-axis when the Particle Generator first spawns them.
+     */
+    get startSizeY(): ParticleCompositeCurve;
+    set startSizeY(value: ParticleCompositeCurve);
+    /**
+     * The initial size of particles along the z-axis when the Particle Generator first spawns them.
+     */
+    get startSizeZ(): ParticleCompositeCurve;
+    set startSizeZ(value: ParticleCompositeCurve);
+    /**
+     * A scale that this Particle Generator applies to gravity, defined by Physics.gravity.
+     */
+    get gravityModifier(): ParticleCompositeCurve;
+    set gravityModifier(value: ParticleCompositeCurve);
+    /**
+     * This selects the space in which to simulate particles. It can be either world or local space.
+     */
+    get simulationSpace(): ParticleSimulationSpace;
+    set simulationSpace(value: ParticleSimulationSpace);
     /**
      * Max particles count.
      */
@@ -68,4 +101,5 @@ export declare class MainModule implements ICustomClone {
      */
     get startSize(): ParticleCompositeCurve;
     set startSize(value: ParticleCompositeCurve);
+    private _onCompositeCurveChange;
 }

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

@@ -4,16 +4,38 @@ import { ParticleCurve } from "./ParticleCurve";
  * Particle composite curve.
  */
 export declare class ParticleCompositeCurve {
-    /** The curve mode. */
-    mode: ParticleCurveMode;
-    /** The min constant value used by the curve if mode is set to `TwoConstants`.*/
-    constantMin: number;
-    /** The max constant value used by the curve if mode is set to `TwoConstants`.*/
-    constantMax: number;
-    /** The min curve used by the curve if mode is set to `TwoCurves`. */
-    curveMin: ParticleCurve;
-    /** The max curve used by the curve if mode is set to `TwoCurves`. */
-    curveMax: ParticleCurve;
+    private _updateManager;
+    private _mode;
+    private _constantMin;
+    private _constantMax;
+    private _curveMin;
+    private _curveMax;
+    private _updateDispatch;
+    /**
+     * The curve mode.
+     */
+    get mode(): ParticleCurveMode;
+    set mode(value: ParticleCurveMode);
+    /**
+     * The min constant value used by the curve if mode is set to `TwoConstants`.
+     */
+    get constantMin(): number;
+    set constantMin(value: number);
+    /**
+     * The max constant value used by the curve if mode is set to `TwoConstants`.
+     */
+    get constantMax(): number;
+    set constantMax(value: number);
+    /**
+     * The min curve used by the curve if mode is set to `TwoCurves`.
+     */
+    get curveMin(): ParticleCurve;
+    set curveMin(value: ParticleCurve);
+    /**
+     * The max curve used by the curve if mode is set to `TwoCurves`.
+     */
+    get curveMax(): ParticleCurve;
+    set curveMax(value: ParticleCurve);
     /**
      * The constant value used by the curve if mode is set to `Constant`.
      */
@@ -53,4 +75,7 @@ export declare class ParticleCompositeCurve {
      * @returns - The result curve value
      */
     evaluate(time: number, lerpFactor: number): number;
+    private _getMaxKeyValue;
+    private _getMinKeyValue;
+    private _onCurveChange;
 }

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

@@ -2,9 +2,11 @@
  * Particle curve.
  */
 export declare class ParticleCurve {
+    private _updateManager;
     private _keys;
     private _typeArray;
     private _typeArrayDirty;
+    private _updateDispatch;
     /**
      * The keys of the curve.
      */
@@ -41,16 +43,21 @@ export declare class ParticleCurve {
  * The key of the curve.
  */
 export declare class CurveKey {
-    /** The key time. */
-    time: number;
-    /** The key value. */
-    value: number;
+    private _updateManager;
+    private _time;
+    private _value;
+    /**
+     * The key time.
+     */
+    get time(): number;
+    set time(value: number);
+    /**
+     * The key value.
+     */
+    get value(): number;
+    set value(value: number);
     /**
      * Create a new key.
      */
-    constructor(
-    /** The key time. */
-    time: number, 
-    /** The key value. */
-    value: number);
+    constructor(time: number, value: number);
 }

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

@@ -4,8 +4,12 @@ import { ParticleGenerator } from "../ParticleGenerator";
  * Particle generator module.
  */
 export declare abstract class ParticleGeneratorModule {
-    /** Specifies whether the module is enabled or not. */
-    enabled: boolean;
     protected _generator: ParticleGenerator;
+    protected _enabled: boolean;
+    /**
+     * Specifies whether the module is enabled or not.
+     */
+    get enabled(): boolean;
+    set enabled(value: boolean);
     protected _enableMacro(shaderData: ShaderData, lastEnableMacro: ShaderMacro, enableMacro: ShaderMacro): ShaderMacro;
 }

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

@@ -1,5 +1,6 @@
 import { ShaderMacro } from "../../shader/ShaderMacro";
 import { ShaderProperty } from "../../shader/ShaderProperty";
+import { ParticleGenerator } from "../ParticleGenerator";
 import { ParticleCompositeCurve } from "./ParticleCompositeCurve";
 import { ParticleGeneratorModule } from "./ParticleGeneratorModule";
 /**
@@ -15,20 +16,38 @@ export declare class SizeOverLifetimeModule extends ParticleGeneratorModule {
     static readonly _maxCurveXProperty: ShaderProperty;
     static readonly _maxCurveYProperty: ShaderProperty;
     static readonly _maxCurveZProperty: ShaderProperty;
-    /** Specifies whether the Size is separate on each axis. */
-    separateAxes: boolean;
-    /** Size curve over lifetime for x axis. */
-    sizeX: ParticleCompositeCurve;
-    /** Size curve over lifetime for y axis. */
-    sizeY: ParticleCompositeCurve;
-    /** Size curve over lifetime for z axis. */
-    sizeZ: ParticleCompositeCurve;
+    private _separateAxes;
+    private _sizeX;
+    private _sizeY;
+    private _sizeZ;
     private _enableSeparateMacro;
     private _isCurveMacro;
     private _isRandomTwoMacro;
+    /**
+     * Specifies whether the Size is separate on each axis.
+     */
+    set separateAxes(value: boolean);
+    get separateAxes(): boolean;
+    /**
+     * Size curve over lifetime for x axis.
+     */
+    get sizeX(): ParticleCompositeCurve;
+    set sizeX(value: ParticleCompositeCurve);
+    /**
+     * Size curve over lifetime for y axis.
+     */
+    get sizeY(): ParticleCompositeCurve;
+    set sizeY(value: ParticleCompositeCurve);
+    /**
+     * Size curve over lifetime for z axis.
+     */
+    get sizeZ(): ParticleCompositeCurve;
+    set sizeZ(value: ParticleCompositeCurve);
     /**
      * Size curve over lifetime.
      */
     get size(): ParticleCompositeCurve;
     set size(value: ParticleCompositeCurve);
+    constructor(generator: ParticleGenerator);
+    private _onCompositeCurveChange;
 }