@galacean/engine-core 0.0.0-experimental-0.9-plus.8 → 0.0.0-experimental-double11.1

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

@@ -0,0 +1,94 @@
+import { Color } from "@galacean/engine-math";
+/**
+ * Particle gradient.
+ */
+export declare class ParticleGradient {
+    private _colorKeys;
+    private _alphaKeys;
+    private _colorTypeArray;
+    private _alphaTypeArray;
+    private _colorTypeArrayDirty;
+    private _alphaTypeArrayDirty;
+    /**
+     * The color keys of the gradient.
+     */
+    get colorKeys(): ReadonlyArray<GradientColorKey>;
+    /**
+     * The alpha keys of the gradient.
+     */
+    get alphaKeys(): ReadonlyArray<GradientAlphaKey>;
+    /**
+     * Create a new particle gradient.
+     * @param colorKeys - The color keys of the gradient
+     * @param alphaKeys - The alpha keys of the gradient
+     */
+    constructor(colorKeys?: GradientColorKey[], alphaKeys?: GradientAlphaKey[]);
+    /**
+     * Add a color key to the gradient.
+     * @param key - The key
+     */
+    addColorKey(key: GradientColorKey): void;
+    /**
+     * Add a color key to the gradient.
+     * @param time - The key time
+     * @param color - The key color
+     */
+    addColorKey(time: number, color: Color): void;
+    /**
+     * Add an alpha key to the gradient.
+     * @param key - The key
+     */
+    addAlphaKey(key: GradientAlphaKey): void;
+    /**
+     * Add an alpha key to the gradient.
+     * @param time - The key time
+     * @param alpha - The key alpha
+     */
+    addAlphaKey(time: number, alpha: number): void;
+    /**
+     * Remove a color key from the gradient.
+     * @param index - The remove color key index
+     */
+    removeColorKey(index: number): void;
+    /**
+     * Remove an alpha key from the gradient.
+     * @param index - The remove alpha key index
+     */
+    removeAlphaKey(index: number): void;
+    /**
+     * Set the keys of the gradient.
+     * @param colorKeys - The color keys
+     * @param alphaKeys - The alpha keys
+     */
+    setKeys(colorKeys: GradientColorKey[], alphaKeys: GradientAlphaKey[]): void;
+    private _addKey;
+    private _removeKey;
+}
+/**
+ * The color key of the particle gradient.
+ */
+export declare class GradientColorKey {
+    /** The key time. */
+    time: number;
+    /** The key color. */
+    color: Color;
+    constructor(
+    /** The key time. */
+    time: number, 
+    /** The key color. */
+    color: Color);
+}
+/**
+ * The alpha key of the particle gradient.
+ */
+export declare class GradientAlphaKey {
+    /** The key time. */
+    time: number;
+    /** The key alpha. */
+    alpha: number;
+    constructor(
+    /** The key time. */
+    time: number, 
+    /** The key alpha. */
+    alpha: number);
+}

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

@@ -0,0 +1,34 @@
+import { ShaderMacro } from "../../shader/ShaderMacro";
+import { ShaderProperty } from "../../shader/ShaderProperty";
+import { ParticleCompositeCurve } from "./ParticleCompositeCurve";
+import { ParticleGeneratorModule } from "./ParticleGeneratorModule";
+/**
+ * Rotate particles throughout their lifetime.
+ */
+export declare class RotationOverLifetimeModule extends ParticleGeneratorModule {
+    static readonly _constantModeMacro: ShaderMacro;
+    static readonly _curveModeMacro: ShaderMacro;
+    static readonly _isSeparateMacro: ShaderMacro;
+    static readonly _isRandomTwoMacro: ShaderMacro;
+    static readonly _minConstantProperty: ShaderProperty;
+    static readonly _minCurveXProperty: ShaderProperty;
+    static readonly _minCurveYProperty: ShaderProperty;
+    static readonly _minCurveZProperty: ShaderProperty;
+    static readonly _maxConstantProperty: ShaderProperty;
+    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. */
+    separateAxes: boolean;
+    /** Rotation over lifetime for z axis. */
+    rotationX: ParticleCompositeCurve;
+    /** Rotation over lifetime for z axis. */
+    rotationY: ParticleCompositeCurve;
+    /** Rotation over lifetime for z axis. */
+    rotationZ: ParticleCompositeCurve;
+    private _rotationMinConstant;
+    private _rotationMaxConstant;
+    private _enableSeparateMacro;
+    private _isCurveMacro;
+    private _isRandomTwoMacro;
+}

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

@@ -0,0 +1,34 @@
+import { ShaderMacro } from "../../shader/ShaderMacro";
+import { ShaderProperty } from "../../shader/ShaderProperty";
+import { ParticleCompositeCurve } from "./ParticleCompositeCurve";
+import { ParticleGeneratorModule } from "./ParticleGeneratorModule";
+/**
+ * Size over lifetime module.
+ */
+export declare class SizeOverLifetimeModule extends ParticleGeneratorModule {
+    static readonly _curveModeMacro: ShaderMacro;
+    static readonly _isSeparateMacro: ShaderMacro;
+    static readonly _isRandomTwoMacro: ShaderMacro;
+    static readonly _minCurveXProperty: ShaderProperty;
+    static readonly _minCurveYProperty: ShaderProperty;
+    static readonly _minCurveZProperty: ShaderProperty;
+    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 _enableSeparateMacro;
+    private _isCurveMacro;
+    private _isRandomTwoMacro;
+    /**
+     * Size curve over lifetime.
+     */
+    get size(): ParticleCompositeCurve;
+    set size(value: ParticleCompositeCurve);
+}

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

@@ -0,0 +1,42 @@
+import { Vector2 } from "@galacean/engine-math";
+import { ParticleCompositeCurve } from "./ParticleCompositeCurve";
+import { ParticleGeneratorModule } from "./ParticleGeneratorModule";
+/**
+ * Texture sheet animation module.
+ */
+export declare class TextureSheetAnimationModule extends ParticleGeneratorModule {
+    private static readonly _frameCurveMacro;
+    private static readonly _frameRandomCurvesMacro;
+    private static readonly _cycleCountProperty;
+    private static readonly _tillingParamsProperty;
+    private static readonly _frameMinCurveProperty;
+    private static readonly _frameMaxCurveProperty;
+    /** Start frame of the texture sheet. */
+    readonly startFrame: ParticleCompositeCurve;
+    /** Frame over time curve of the texture sheet. */
+    readonly frameOverTime: ParticleCompositeCurve;
+    /** Texture sheet animation type. */
+    type: TextureSheetAnimationType;
+    /** Cycle count. */
+    cycleCount: number;
+    private _tiling;
+    private _textureSheetMacro;
+    /**
+     * Tiling of the texture sheet.
+     * */
+    get tiling(): Vector2;
+    set tiling(value: Vector2);
+    /**
+     * @inheritDoc
+     */
+    cloneTo(dest: TextureSheetAnimationModule): void;
+}
+/**
+ * Texture sheet animation type.
+ */
+export declare enum TextureSheetAnimationType {
+    /** Animate over the whole texture sheet from left to right, top to bottom. */
+    WholeSheet = 0,
+    /** Animate a single row in the sheet from left to right. */
+    SingleRow = 1
+}

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

@@ -0,0 +1,34 @@
+import { ShaderMacro } from "../../shader";
+import { ShaderProperty } from "../../shader/ShaderProperty";
+import { ParticleSimulationSpace } from "../enums/ParticleSimulationSpace";
+import { ParticleCompositeCurve } from "./ParticleCompositeCurve";
+import { ParticleGeneratorModule } from "./ParticleGeneratorModule";
+/**
+ * Velocity over lifetime module.
+ */
+export declare class VelocityOverLifetimeModule extends ParticleGeneratorModule {
+    static readonly _constantMacro: ShaderMacro;
+    static readonly _curveMacro: ShaderMacro;
+    static readonly _randomConstantMacro: ShaderMacro;
+    static readonly _randomCurveMacro: ShaderMacro;
+    static readonly _minConstantProperty: ShaderProperty;
+    static readonly _maxConstantProperty: ShaderProperty;
+    static readonly _minGradientXProperty: ShaderProperty;
+    static readonly _minGradientYProperty: ShaderProperty;
+    static readonly _minGradientZProperty: ShaderProperty;
+    static readonly _maxGradientXProperty: ShaderProperty;
+    static readonly _maxGradientYProperty: ShaderProperty;
+    static readonly _maxGradientZProperty: ShaderProperty;
+    static readonly _spaceProperty: ShaderProperty;
+    /** Velocity over lifetime for x axis. */
+    velocityX: ParticleCompositeCurve;
+    /** Velocity over lifetime for z axis. */
+    velocityY: ParticleCompositeCurve;
+    /** Velocity over lifetime for z axis. */
+    velocityZ: ParticleCompositeCurve;
+    /** Velocity space. */
+    space: ParticleSimulationSpace;
+    private _velocityMinConstant;
+    private _velocityMaxConstant;
+    private _velocityMacro;
+}

package/types/particle/modules/shape/BaseShape.d.ts

@@ -0,0 +1,12 @@
+import { ParticleShapeType } from "./enums/ParticleShapeType";
+/**
+ * Base class for all particle shapes.
+ */
+export declare abstract class BaseShape {
+    /** The type of shape to emit particles from. */
+    shapeType: ParticleShapeType;
+    /** Specifies whether the ShapeModule is enabled or disabled. */
+    enable: boolean;
+    /** Randomizes the starting direction of particles. */
+    randomDirectionAmount: number;
+}

package/types/particle/modules/shape/BoxShape.d.ts

@@ -0,0 +1,11 @@
+import { Vector3 } from "@galacean/engine-math";
+import { BaseShape } from "./BaseShape";
+/**
+ * Particle shape that emits particles from a box.
+ */
+export declare class BoxShape extends BaseShape {
+    private static _tempVector30;
+    /** The size of the box. */
+    size: Vector3;
+    constructor();
+}

package/types/particle/modules/shape/CircleShape.d.ts

@@ -0,0 +1,17 @@
+import { BaseShape } from "./BaseShape";
+import { ParticleShapeArcMode } from "./enums/ParticleShapeArcMode";
+/**
+ * Particle shape that emits particles from a circle.
+ */
+export declare class CircleShape extends BaseShape {
+    private static _tempPositionPoint;
+    /** Radius of the shape to emit particles from. */
+    radius: number;
+    /** Angle of the circle arc to emit particles from. */
+    arc: number;
+    /** The mode to generate particles around the arc. */
+    arcMode: ParticleShapeArcMode;
+    /** The speed of complete 360 degree rotation. */
+    arcSpeed: number;
+    constructor();
+}

package/types/particle/modules/shape/ConeShape.d.ts

@@ -0,0 +1,28 @@
+import { BaseShape } from "./BaseShape";
+/**
+ * Cone shape.
+ */
+export declare class ConeShape extends BaseShape {
+    private static _tempVector20;
+    private static _tempVector21;
+    private static _tempVector30;
+    private static _tempVector31;
+    /** Angle of the cone to emit particles from. */
+    angle: number;
+    /** Radius of the shape to emit particles from. */
+    radius: number;
+    /** Length of the cone to emit particles from. */
+    length: number;
+    /** Cone emitter type. */
+    emitType: ConeEmitType;
+    constructor();
+}
+/**
+ * Cone emitter type.
+ */
+export declare enum ConeEmitType {
+    /** Emit particles from the base of the cone. */
+    Base = 0,
+    /** Emit particles from the volume of the cone. */
+    Volume = 1
+}

package/types/particle/modules/shape/HemisphereShape.d.ts

@@ -0,0 +1,9 @@
+import { BaseShape } from "./BaseShape";
+/**
+ * Particle shape that emits particles from a hemisphere.
+ */
+export declare class HemisphereShape extends BaseShape {
+    /** Radius of the shape to emit particles from. */
+    radius: number;
+    constructor();
+}

package/types/particle/modules/shape/ShapeUtils.d.ts

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

package/types/particle/modules/shape/SphereShape.d.ts

@@ -0,0 +1,9 @@
+import { BaseShape } from "./BaseShape";
+/**
+ * Particle shape that emits particles from a sphere.
+ */
+export declare class SphereShape extends BaseShape {
+    /** Radius of the shape to emit particles from. */
+    radius: number;
+    constructor();
+}

package/types/particle/modules/shape/enums/ParticleShapeArcMode.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Particle shape multi mode value.
+ */
+export declare enum ParticleShapeArcMode {
+    /** Generate points randomly. */
+    Random = 0,
+    /** Animate the emission point around the shape. */
+    Loop = 1
+}

package/types/particle/modules/shape/enums/ParticleShapeType.d.ts

@@ -0,0 +1,15 @@
+/**
+ * The emission shape.
+ */
+export declare enum ParticleShapeType {
+    /** Emit from the volume of a box. */
+    Box = 0,
+    /** Emit from a circle. */
+    Circle = 1,
+    /** Emit from the base of a cone. */
+    Cone = 2,
+    /** Emit from a half-sphere. */
+    Hemisphere = 3,
+    /** Emit from a sphere. */
+    Sphere = 4
+}

package/types/particle/modules/shape/index.d.ts

@@ -0,0 +1,6 @@
+export { BoxShape } from "./BoxShape";
+export { CircleShape } from "./CircleShape";
+export { ConeShape, ConeEmitType } from "./ConeShape";
+export { HemisphereShape } from "./HemisphereShape";
+export { SphereShape } from "./SphereShape";
+export { ParticleShapeArcMode } from "./enums/ParticleShapeArcMode";

package/types/physics/CharacterController.d.ts

@@ -41,12 +41,10 @@ export declare class CharacterController extends Collider {
     /**
      * Add collider shape on this controller.
      * @param shape - Collider shape
-     * @override
      */
     addShape(shape: ColliderShape): void;
     /**
      * Remove all shape attached.
-     * @override
      */
     clearShapes(): void;
     private _setUpDirection;

package/types/physics/Collider.d.ts

@@ -1,11 +1,12 @@
 import { BoolUpdateFlag } from "../BoolUpdateFlag";
 import { Component } from "../Component";
 import { ColliderShape } from "./shape/ColliderShape";
+import { ICustomClone } from "../clone/ComponentCloner";
 /**
  * Base class for all colliders.
- * @decorator `@dependentComponents(Transform)`
+ * @decorator `@dependentComponents(Transform, DependentMode.CheckOnly)`
  */
-export declare class Collider extends Component {
+export declare class Collider extends Component implements ICustomClone {
     protected _updateFlag: BoolUpdateFlag;
     protected _shapes: ColliderShape[];
     /**

package/types/physics/PhysicsManager.d.ts

@@ -1,4 +1,3 @@
-import { IPhysics } from "@galacean/engine-design";
 import { Ray, Vector3 } from "@galacean/engine-math";
 import { Engine } from "../Engine";
 import { Layer } from "../Layer";
@@ -7,8 +6,10 @@ 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;
@@ -19,33 +20,15 @@ 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);
-    /**
-     * @deprecated
-     * Please use `maxAllowedTimeStep` instead.
-     */
-    get maxSumTimeStep(): number;
-    set maxSumTimeStep(value: number);
+    /** The fixed time step in seconds at which physics are performed. */
+    get fixedTimeStep(): number;
+    set fixedTimeStep(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

package/types/physics/PhysicsScene.d.ts

@@ -9,6 +9,7 @@ export declare class PhysicsScene {
     private static _collision;
     private _scene;
     private _restTime;
+    private _fixedTimeStep;
     private _colliders;
     private _gravity;
     private _nativePhysicsScene;
@@ -18,13 +19,16 @@ export declare class PhysicsScene {
     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);
+    /**
+     * The fixed time step in seconds at which physics are performed.
+     */
+    get fixedTimeStep(): number;
+    set fixedTimeStep(value: number);
     constructor(scene: Scene);
     /**
      * Casts a ray through the Scene and returns the first hit.

package/types/physics/joint/HingeJoint.d.ts

@@ -1,7 +1,7 @@
-import { Joint } from "./Joint";
 import { Vector3 } from "@galacean/engine-math";
-import { JointMotor } from "./JointMotor";
+import { Joint } from "./Joint";
 import { JointLimits } from "./JointLimits";
+import { JointMotor } from "./JointMotor";
 /**
  * A joint which behaves in a similar way to a hinge or axle.
  */

package/types/physics/joint/Joint.d.ts

@@ -1,15 +1,14 @@
 import { IJoint } from "@galacean/engine-design";
 import { Vector3 } from "@galacean/engine-math";
 import { Component } from "../../Component";
-import { Collider } from "../Collider";
 import { Entity } from "../../Entity";
+import { Collider } from "../Collider";
 /**
  * A base class providing common functionality for joints.
- * @decorator `@dependentComponents(Collider)`
+ * @decorator `@dependentComponents(Collider, DependentMode.CheckOnly)`
  */
 export declare class Joint extends Component {
-    protected _connectedCollider: JointCollider;
-    protected _collider: JointCollider;
+    protected _connectedColliderInfo: JointCollider;
     protected _nativeJoint: IJoint;
     private _force;
     private _torque;

package/types/physics/joint/SpringJoint.d.ts

@@ -1,9 +1,10 @@
-import { Joint } from "./Joint";
 import { Vector3 } from "@galacean/engine-math";
+import { ICustomClone } from "../../clone/ComponentCloner";
+import { Joint } from "./Joint";
 /**
  * A joint that maintains an upper or lower bound (or both) on the distance between two points on different objects.
  */
-export declare class SpringJoint extends Joint {
+export declare class SpringJoint extends Joint implements ICustomClone {
     private _minDistance;
     private _maxDistance;
     private _tolerance;

package/types/physics/shape/BoxColliderShape.d.ts

@@ -11,5 +11,7 @@ export declare class BoxColliderShape extends ColliderShape {
     get size(): Vector3;
     set size(value: Vector3);
     constructor();
+    clone(): BoxColliderShape;
+    cloneTo(target: BoxColliderShape): void;
     private _setSize;
 }

package/types/physics/shape/CapsuleColliderShape.d.ts

@@ -23,4 +23,6 @@ export declare class CapsuleColliderShape extends ColliderShape {
     get upAxis(): ColliderShapeUpAxis;
     set upAxis(value: ColliderShapeUpAxis);
     constructor();
+    clone(): CapsuleColliderShape;
+    cloneTo(target: CapsuleColliderShape): void;
 }

package/types/physics/shape/ColliderShape.d.ts

@@ -1,10 +1,11 @@
+import { IClone } from "@galacean/engine-design";
 import { PhysicsMaterial } from "../PhysicsMaterial";
 import { Vector3 } from "@galacean/engine-math";
 import { Collider } from "../Collider";
 /**
  * Abstract class for collider shapes.
  */
-export declare abstract class ColliderShape {
+export declare abstract class ColliderShape implements IClone {
     private static _idGenerator;
     protected _id: number;
     protected _material: PhysicsMaterial;
@@ -46,6 +47,8 @@ export declare abstract class ColliderShape {
     get isTrigger(): boolean;
     set isTrigger(value: boolean);
     protected constructor();
+    abstract clone(): ColliderShape;
+    cloneTo(target: ColliderShape): void;
     private _setPosition;
     private _setRotation;
 }

package/types/physics/shape/PlaneColliderShape.d.ts

@@ -4,4 +4,5 @@ import { ColliderShape } from "./ColliderShape";
  */
 export declare class PlaneColliderShape extends ColliderShape {
     constructor();
+    clone(): PlaneColliderShape;
 }

package/types/physics/shape/SphereColliderShape.d.ts

@@ -10,4 +10,6 @@ export declare class SphereColliderShape extends ColliderShape {
     get radius(): number;
     set radius(value: number);
     constructor();
+    clone(): SphereColliderShape;
+    cloneTo(target: SphereColliderShape): void;
 }

package/types/renderingHardwareInterface/index.d.ts

@@ -1,4 +1,5 @@
 export type { IHardwareRenderer } from "./IHardwareRenderer";
+export type { IPlatformBuffer } from "./IPlatformBuffer";
 export type { IPlatformRenderTarget } from "./IPlatformRenderTarget";
 export type { IPlatformTexture } from "./IPlatformTexture";
 export type { IPlatformTexture2D } from "./IPlatformTexture2D";