@galacean/engine-core 0.0.0-experimental-shaderlab.2 → 0.0.0-experimental-stateMachine.0

package/package.json

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

package/types/animation/Animator.d.ts

@@ -2,7 +2,10 @@ import { BoolUpdateFlag } from "../BoolUpdateFlag";
 import { Component } from "../Component";
 import { AnimatorController } from "./AnimatorController";
 import { AnimatorState } from "./AnimatorState";
+import { AnimatorStateTransition } from "./AnimatorTransition";
 import { AnimatorCullingMode } from "./enums/AnimatorCullingMode";
+import { AnimatorControllerLayer } from "./AnimatorControllerLayer";
+import { AnimatorControllerParameter, AnimatorControllerParameterValue } from "./AnimatorControllerParameter";
 /**
  * The controller of the animation system.
  */
@@ -24,6 +27,14 @@ export declare class Animator extends Component {
      */
     get animatorController(): AnimatorController;
     set animatorController(animatorController: AnimatorController);
+    /**
+     * The layers in the animator's controller.
+     */
+    get layers(): Readonly<AnimatorControllerLayer[]>;
+    /**
+     * The parameters in the animator's controller.
+     */
+    get parameters(): Readonly<AnimatorControllerParameter[]>;
     /**
      * Play a state by name.
      * @param stateName - The state name
@@ -39,6 +50,7 @@ export declare class Animator extends Component {
      * @param normalizedTimeOffset - The time offset between 0 and 1(default 0)
      */
     crossFade(stateName: string, normalizedTransitionDuration: number, layerIndex?: number, normalizedTimeOffset?: number): void;
+    crossFade(transition: AnimatorStateTransition, layerIndex?: number): void;
     /**
      * Evaluates the animator component based on deltaTime.
      * @param deltaTime - The deltaTime when the animation update
@@ -55,6 +67,21 @@ export declare class Animator extends Component {
      * @param layerIndex - The layer index(default -1). If layer is -1, find the first state with the given state name
      */
     findAnimatorState(stateName: string, layerIndex?: number): AnimatorState;
+    /**
+     * Get the layer by name.
+     * @param name - The layer's name.
+     */
+    findLayerByName(name: string): AnimatorControllerLayer;
+    /**
+     * 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
+     */
+    setParameter(name: string, value: AnimatorControllerParameterValue): void;
     private _getAnimatorStateInfo;
     private _getAnimatorStateData;
     private _saveAnimatorStateData;
@@ -77,6 +104,8 @@ export declare class Animator extends Component {
     private _checkTransition;
     private _checkSubTransition;
     private _checkBackwardsSubTransition;
+    _applyTransition(transition: AnimatorStateTransition, layerIndex: number): void;
+    private _checkConditions;
     private _crossFadeByTransition;
     private _fireAnimationEvents;
     private _fireSubAnimationEvents;
@@ -84,6 +113,6 @@ export declare class Animator extends Component {
     private _callAnimatorScriptOnEnter;
     private _callAnimatorScriptOnUpdate;
     private _callAnimatorScriptOnExit;
-    private _checkAutoPlay;
+    private _checkEntryState;
     private _checkRevertOwner;
 }

package/types/animation/AnimatorCondition.d.ts

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

package/types/animation/AnimatorController.d.ts

@@ -1,15 +1,34 @@
+import { AnimatorControllerParameter, AnimatorControllerParameterValue } from "./AnimatorControllerParameter";
 import { AnimatorControllerLayer } from "./AnimatorControllerLayer";
 /**
  * Store the data for Animator playback.
  */
 export declare class AnimatorController {
     private _updateFlagManager;
-    private _layers;
-    private _layersMap;
     /**
      * The layers in the controller.
      */
     get layers(): Readonly<AnimatorControllerLayer[]>;
+    /**
+     * The parameters in the controller.
+     */
+    get parameters(): Readonly<AnimatorControllerParameter[]>;
+    /**
+     * Add a parameter to the controller.
+     * @param name - The name of the parameter
+     * @param defaultValue - The defaultValue of the parameter
+     */
+    addParameter(name: string, defaultValue?: AnimatorControllerParameterValue): AnimatorControllerParameter;
+    /**
+     * Add a parameter to the controller.
+     * @param parameter - The parameter
+     */
+    addParameter(parameter: AnimatorControllerParameter): AnimatorControllerParameter;
+    /**
+     * Remove a parameter from the controller.
+     * @param parameter - The parameter
+     */
+    removeParameter(parameter: AnimatorControllerParameter): void;
     /**
      * Get the layer by name.
      * @param name - The layer's name.

package/types/animation/AnimatorControllerParameter.d.ts

@@ -0,0 +1,10 @@
+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: AnimatorControllerParameterValue;
+}

package/types/animation/AnimatorState.d.ts

@@ -25,12 +25,20 @@ 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 start time of this state's clip
+     */
+    get startTime(): number;
+    /**
+     * The end time of this state's clip
+     */
+    get endTime(): number;
+    /**
+     * 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 +47,15 @@ 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;
     /**
      * 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 "./AnimatorTransition";
 export interface AnimatorStateMap {
     [key: string]: AnimatorState;
 }
@@ -13,6 +14,14 @@ export declare class AnimatorStateMachine {
      * @remarks When the Animator's AnimatorController changed or the Animator's onEnable be triggered.
      */
     defaultState: AnimatorState;
+    /**
+     * 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 +43,34 @@ 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;
 }

package/types/animation/AnimatorTransition.d.ts

@@ -1,3 +1,6 @@
+import { AnimatorControllerParameterValue } 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.
@@ -11,4 +14,34 @@ export declare class AnimatorStateTransition {
     exitTime: number;
     /** The destination state of the transition. */
     destinationState: AnimatorState;
+    /** Mutes the transition. The transition will never occur. */
+    mute: boolean;
+    /** Is the transition destination the exit of the current state machine. */
+    isExit: boolean;
+    private _conditions;
+    private _solo;
+    /** 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 parameter - The name of the parameter
+     * @param threshold - The threshold value of the condition
+     */
+    addCondition(mode: AnimatorConditionMode, parameter: string, threshold?: AnimatorControllerParameterValue): 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/asset/AssetType.d.ts

@@ -23,10 +23,6 @@ export declare enum AssetType {
     TextureCube = "TextureCube",
     /** Material. */
     Material = "Material",
-    /** Shader */
-    Shader = "Shader",
-    /** Shader Chunk */
-    ShaderChunk = "ShaderChunk",
     /** Mesh. */
     Mesh = "Mesh",
     /** AnimationClip. */

package/types/RenderPipeline/MeshRenderData.d.ts

@@ -1,17 +0,0 @@
-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 implements IPoolElement {
-    /** Mesh. */
-    mesh: Mesh;
-    /** Sub mesh. */
-    subMesh: SubMesh;
-    set(component: Renderer, material: Material, mesh: Mesh, subMesh: SubMesh): void;
-    dispose(): void;
-}

package/types/RenderPipeline/RenderPass.d.ts

@@ -1,55 +0,0 @@
-import { Color } from "@galacean/engine-math";
-import { Camera } from "../Camera";
-import { CameraClearFlags } from "../enums/CameraClearFlags";
-import { Layer } from "../Layer";
-import { Material } from "../material/Material";
-import { RenderTarget } from "../texture/RenderTarget";
-import { RenderQueue } from "./RenderQueue";
-/**
- * RenderPass.
- */
-declare class RenderPass {
-    name: string;
-    enabled: boolean;
-    priority: number;
-    renderTarget: RenderTarget;
-    replaceMaterial: Material;
-    mask: Layer;
-    renderOverride: boolean;
-    clearFlags: CameraClearFlags | undefined;
-    clearColor: Color | undefined;
-    /**
-     * Create a RenderPass.
-     * @param name - Pass name
-     * @param priority - Priority, less than 0 before the default pass, greater than 0 after the default pass
-     * @param renderTarget - The specified Render Target
-     * @param replaceMaterial - Replaced material
-     * @param mask - Perform bit and operations with Entity.Layer to filter the objects that this Pass needs to render
-     */
-    constructor(name?: string, priority?: number, renderTarget?: any, replaceMaterial?: any, mask?: any);
-    /**
-     * Rendering callback, will be executed if renderOverride is set to true.
-     * @param camera - Camera
-     * @param opaqueQueue - Opaque queue
-     * @param alphaTestQueue - Alpha test queue
-     * @param transparentQueue - Transparent queue
-     */
-    render(camera: Camera, opaqueQueue: RenderQueue, alphaTestQueue: RenderQueue, transparentQueue: RenderQueue): void;
-    /**
-     * Post rendering callback.
-     * @param camera - Camera
-     * @param opaqueQueue - Opaque queue
-     * @param alphaTestQueue - Alpha test queue
-     * @param transparentQueue - Transparent queue
-     */
-    preRender(camera: Camera, opaqueQueue: RenderQueue, alphaTestQueue: RenderQueue, transparentQueue: RenderQueue): void;
-    /**
-     * Post rendering callback.
-     * @param camera - Camera
-     * @param opaqueQueue - Opaque queue
-     * @param alphaTestQueue - Alpha test queue
-     * @param transparentQueue - Transparent queue
-     */
-    postRender(camera: Camera, opaqueQueue: RenderQueue, alphaTestQueue: RenderQueue, transparentQueue: RenderQueue): void;
-}
-export { RenderPass };

package/types/physics/PhysicsManager.d.ts

@@ -1,76 +0,0 @@
-import { Ray, Vector3 } from "@galacean/engine-math";
-import { Engine } from "../Engine";
-import { Layer } from "../Layer";
-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 _colliders;
-    private _gravity;
-    private _nativePhysicsManager;
-    private _physicalObjectsMap;
-    private _onContactEnter;
-    private _onContactExit;
-    private _onContactStay;
-    private _onTriggerEnter;
-    private _onTriggerExit;
-    private _onTriggerStay;
-    /** The fixed time step in seconds at which physics are performed. */
-    fixedTimeStep: number;
-    /**
-     * The gravity of physics scene.
-     */
-    get gravity(): Vector3;
-    set gravity(value: Vector3);
-    constructor(engine: Engine);
-    /**
-     * Casts a ray through the Scene and returns the first hit.
-     * @param ray - The ray
-     * @returns Returns True if the ray intersects with a collider, otherwise false
-     */
-    raycast(ray: Ray): boolean;
-    /**
-     * Casts a ray through the Scene and returns the first hit.
-     * @param ray - The ray
-     * @param outHitResult - If true is returned, outHitResult will contain more detailed collision information
-     * @returns Returns True if the ray intersects with a collider, otherwise false
-     */
-    raycast(ray: Ray, outHitResult: HitResult): boolean;
-    /**
-     * Casts a ray through the Scene and returns the first hit.
-     * @param ray - The ray
-     * @param distance - The max distance the ray should check
-     * @returns Returns True if the ray intersects with a collider, otherwise false
-     */
-    raycast(ray: Ray, distance: number): boolean;
-    /**
-     * Casts a ray through the Scene and returns the first hit.
-     * @param ray - The ray
-     * @param distance - The max distance the ray should check
-     * @param outHitResult - If true is returned, outHitResult will contain more detailed collision information
-     * @returns Returns True if the ray intersects with a collider, otherwise false
-     */
-    raycast(ray: Ray, distance: number, outHitResult: HitResult): boolean;
-    /**
-     * Casts a ray through the Scene and returns the first hit.
-     * @param ray - The ray
-     * @param distance - The max distance the ray should check
-     * @param layerMask - Layer mask that is used to selectively ignore Colliders when casting
-     * @returns Returns True if the ray intersects with a collider, otherwise false
-     */
-    raycast(ray: Ray, distance: number, layerMask: Layer): boolean;
-    /**
-     * Casts a ray through the Scene and returns the first hit.
-     * @param ray - The ray
-     * @param distance - The max distance the ray should check
-     * @param layerMask - Layer mask that is used to selectively ignore Colliders when casting
-     * @param outHitResult - If true is returned, outHitResult will contain more detailed collision information
-     * @returns Returns True if the ray intersects with a collider, otherwise false.
-     */
-    raycast(ray: Ray, distance: number, layerMask: Layer, outHitResult: HitResult): boolean;
-    private _setGravity;
-}

package/types/renderingHardwareInterface/IHardwareRenderer.d.ts

@@ -1,6 +0,0 @@
-/**
- * Hardware graphics API renderer.
- */
-export interface IHardwareRenderer {
-    [key: string]: any;
-}