@galacean/effects-core 2.0.3 → 2.0.4

package/dist/plugins/cal/calculate-item.d.ts

@@ -1,5 +1,7 @@
 import type { Euler, Vector3 } from '@galacean/effects-math/es/core/index';
 import type { ValueGetter } from '../../math';
+import { TrackAsset } from '../timeline/track';
+import type { TimelineAsset } from './timeline-asset';
 /**
  * 基础位移属性数据
  */
@@ -16,3 +18,9 @@ export type ItemLinearVelOverLifetime = {
     z?: ValueGetter<number>;
     enabled?: boolean;
 };
+/**
+ * @since 2.0.0
+ */
+export declare class ObjectBindingTrack extends TrackAsset {
+    create(timelineAsset: TimelineAsset): void;
+}

package/dist/plugins/cal/calculate-vfx-item.d.ts

@@ -2,10 +2,54 @@ import { Vector3 } from '@galacean/effects-math/es/core/vector3';
 import type { Quaternion } from '@galacean/effects-math/es/core/quaternion';
 import * as spec from '@galacean/effects-specification';
 import type { ValueGetter } from '../../math';
+import { AnimationPlayable } from './animation-playable';
+import type { ItemBasicTransform, ItemLinearVelOverLifetime } from './calculate-item';
 import type { FrameContext, PlayableGraph } from './playable-graph';
 import { Playable, PlayableAsset } from './playable-graph';
 import { EffectsObject } from '../../effects-object';
 import { VFXItem } from '../../vfx-item';
+/**
+ * @since 2.0.0
+ */
+export declare class TransformAnimationPlayable extends AnimationPlayable {
+    originalTransform: ItemBasicTransform;
+    protected sizeSeparateAxes: boolean;
+    protected sizeXOverLifetime: ValueGetter<number>;
+    protected sizeYOverLifetime: ValueGetter<number>;
+    protected sizeZOverLifetime: ValueGetter<number>;
+    protected rotationOverLifetime: {
+        asRotation?: boolean;
+        separateAxes?: boolean;
+        enabled?: boolean;
+        x?: ValueGetter<number>;
+        y?: ValueGetter<number>;
+        z?: ValueGetter<number>;
+    };
+    gravityModifier: ValueGetter<number>;
+    orbitalVelOverLifetime: {
+        x?: ValueGetter<number>;
+        y?: ValueGetter<number>;
+        z?: ValueGetter<number>;
+        center: [x: number, y: number, z: number];
+        asRotation?: boolean;
+        enabled?: boolean;
+    };
+    speedOverLifetime?: ValueGetter<number>;
+    linearVelOverLifetime: ItemLinearVelOverLifetime;
+    positionOverLifetime: spec.PositionOverLifetime;
+    gravity: Vector3;
+    direction: Vector3;
+    startSpeed: number;
+    data: TransformPlayableAssetData;
+    private velocity;
+    private binding;
+    start(): void;
+    processFrame(context: FrameContext): void;
+    /**
+     * 应用时间轴K帧数据到对象
+     */
+    private sampleAnimation;
+}
 export declare class TransformPlayableAsset extends PlayableAsset {
     transformAnimationData: TransformPlayableAssetData;
     createPlayable(graph: PlayableGraph): Playable;
@@ -25,6 +69,12 @@ export interface TransformPlayableAssetData extends spec.EffectsObjectData {
      */
     positionOverLifetime?: spec.PositionOverLifetime;
 }
+/**
+ * @since 2.0.0
+ */
+export declare class ActivationPlayable extends Playable {
+    processFrame(context: FrameContext): void;
+}
 export declare class ActivationPlayableAsset extends PlayableAsset {
     createPlayable(graph: PlayableGraph): Playable;
 }

package/dist/plugins/cal/playable-graph.d.ts

@@ -1,4 +1,94 @@
 import { EffectsObject } from '../../effects-object';
+import type { Disposable } from '../../utils';
+/**
+ * 动画图，负责更新所有的动画节点
+ * @since 2.0.0
+ */
+export declare class PlayableGraph {
+    private playableOutputs;
+    private playables;
+    evaluate(dt: number): void;
+    connect(source: Playable, sourceOutputPort: number, destination: Playable, destinationInputPort: number): void;
+    addOutput(output: PlayableOutput): void;
+    addPlayable(playable: Playable): void;
+    private processFrameWithRoot;
+    private prepareFrameWithRoot;
+    private updatePlayableTime;
+}
+/**
+ * 动画图可播放节点对象
+ * @since 2.0.0
+ */
+export declare class Playable implements Disposable {
+    onPlayablePlayFlag: boolean;
+    onPlayablePauseFlag: boolean;
+    overrideTimeNextEvaluation: boolean;
+    private destroyed;
+    private inputs;
+    private inputOuputPorts;
+    private inputWeight;
+    private outputs;
+    private playState;
+    private traversalMode;
+    /**
+     * 当前本地播放的时间
+     */
+    protected time: number;
+    constructor(graph: PlayableGraph, inputCount?: number);
+    play(): void;
+    pause(): void;
+    connectInput(inputPort: number, sourcePlayable: Playable, sourceOutputPort: number, weight?: number): void;
+    addInput(sourcePlayable: Playable, sourceOutputPort: number, weight?: number): void;
+    getInputCount(): number;
+    getInputs(): Playable[];
+    getInput(index: number): Playable;
+    getOutputCount(): number;
+    getOutputs(): Playable[];
+    getOutput(index: number): Playable;
+    getInputWeight(inputIndex: number): number;
+    setInputWeight(playable: Playable, weight: number): void;
+    setInputWeight(inputIndex: number, weight: number): void;
+    setTime(time: number): void;
+    getTime(): number;
+    getPlayState(): PlayState;
+    setTraversalMode(mode: PlayableTraversalMode): void;
+    getTraversalMode(): PlayableTraversalMode;
+    onPlayablePlay(context: FrameContext): void;
+    onPlayablePause(context: FrameContext): void;
+    prepareFrame(context: FrameContext): void;
+    processFrame(context: FrameContext): void;
+    onPlayableDestroy(): void;
+    dispose(): void;
+    private setOutput;
+    private setInput;
+}
+/**
+ * 动画图输出节点对象，将动画数据采样到绑定的元素属性上
+ * @since 2.0.0
+ */
+export declare class PlayableOutput {
+    /**
+     * 绑定到的动画 item
+     */
+    userData: object;
+    /**
+     * 源 playable 对象
+     */
+    sourcePlayable: Playable;
+    context: FrameContext;
+    /**
+     * 当前本地播放的时间
+     */
+    protected time: number;
+    private sourceOutputPort;
+    constructor();
+    setSourcePlayeble(playable: Playable, port?: number): void;
+    getSourceOutputPort(): number;
+    setUserData(value: object): void;
+    getUserData(): object;
+    prepareFrame(): void;
+    processFrame(): void;
+}
 export declare abstract class PlayableAsset extends EffectsObject {
     abstract createPlayable(graph: PlayableGraph): Playable;
 }

package/dist/plugins/particle/particle-system.d.ts

@@ -159,6 +159,7 @@ export declare class ParticleSystem extends Component {
     get lifetime(): number;
     get particleCount(): number;
     isFrozen(): boolean;
+    isEnded(): boolean;
     initEmitterTransform(): void;
     private updateEmitterTransform;
     private addParticle;

package/dist/plugins/particle/particle-vfx-item.d.ts

@@ -1,5 +1,15 @@
-import type { PlayableGraph } from '../cal/playable-graph';
+import type { FrameContext, PlayableGraph } from '../cal/playable-graph';
 import { Playable, PlayableAsset } from '../cal/playable-graph';
+import { ParticleSystem } from './particle-system';
+/**
+ * @since 2.0.0
+ */
+export declare class ParticleBehaviourPlayable extends Playable {
+    lastTime: number;
+    particleSystem: ParticleSystem;
+    start(context: FrameContext): void;
+    processFrame(context: FrameContext): void;
+}
 export declare class ParticleBehaviourPlayableAsset extends PlayableAsset {
     createPlayable(graph: PlayableGraph): Playable;
 }

package/dist/plugins/timeline/playables/sub-composition-mixer-playable.d.ts

@@ -0,0 +1,5 @@
+import type { FrameContext } from '../../cal/playable-graph';
+import { Playable } from '../../cal/playable-graph';
+export declare class SubCompositionMixerPlayable extends Playable {
+    processFrame(context: FrameContext): void;
+}

package/dist/plugins/timeline/track.d.ts

@@ -1,5 +1,52 @@
-import { Playable } from '../cal/playable-graph';
+import { EndBehavior } from '@galacean/effects-specification';
+import type { PlayableGraph } from '../cal/playable-graph';
+import { Playable, PlayableAsset, PlayableOutput } from '../cal/playable-graph';
 import { ParticleSystem } from '../particle/particle-system';
+import type { Constructor } from '../../utils';
+/**
+ * @since 2.0.0
+ */
+export declare class TimelineClip {
+    id: string;
+    name: string;
+    start: number;
+    duration: number;
+    asset: PlayableAsset;
+    endBehavior: EndBehavior;
+    constructor();
+    toLocalTime(time: number): number;
+}
+/**
+ * @since 2.0.0
+ */
+export declare class TrackAsset extends PlayableAsset {
+    name: string;
+    binding: object;
+    trackType: TrackType;
+    private clipSeed;
+    private clips;
+    protected children: TrackAsset[];
+    /**
+     * 重写该方法以获取自定义对象绑定
+     */
+    resolveBinding(parentBinding: object): object;
+    /**
+     * 重写该方法以创建自定义混合器
+     */
+    createTrackMixer(graph: PlayableGraph): Playable;
+    createOutput(): PlayableOutput;
+    createPlayableGraph(graph: PlayableGraph, runtimeClips: RuntimeClip[]): Playable;
+    createMixerPlayableGraph(graph: PlayableGraph, runtimeClips: RuntimeClip[]): Playable;
+    compileClips(graph: PlayableGraph, timelineClips: TimelineClip[], runtimeClips: RuntimeClip[]): Playable;
+    createPlayable(graph: PlayableGraph): Playable;
+    getChildTracks(): TrackAsset[];
+    addChild(child: TrackAsset): void;
+    createClip<T extends PlayableAsset>(classConstructor: Constructor<T>, name?: string): TimelineClip;
+    getClips(): TimelineClip[];
+    findClip(name: string): TimelineClip | undefined;
+    addClip(clip: TimelineClip): void;
+    private createClipPlayable;
+}
 export declare enum TrackType {
     MasterTrack = 0,
     ObjectTrack = 1
@@ -14,3 +61,9 @@ export declare class RuntimeClip {
     set enable(value: boolean);
     evaluateAt(localTime: number): void;
 }
+/**
+ * @since 2.0.0
+ */
+export interface TimelineClipData {
+    asset: PlayableAsset;
+}

package/dist/plugins/timeline/tracks/sub-composition-track.d.ts

@@ -1,4 +1,6 @@
 import { TrackAsset } from '../track';
+import type { PlayableGraph, Playable } from '../../cal/playable-graph';
 export declare class SubCompositionTrack extends TrackAsset {
     resolveBinding(parentBinding: object): object;
+    createTrackMixer(graph: PlayableGraph): Playable;
 }

package/dist/ticker.d.ts

@@ -1,3 +1,4 @@
+export declare const DEFAULT_FPS = 60;
 /**
  * 定时器类
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@galacean/effects-core",
-  "version": "2.0.3",
+  "version": "2.0.4",
   "description": "Galacean Effects runtime core for the web",
   "module": "./dist/index.mjs",
   "main": "./dist/index.js",