@galacean/effects-core 2.6.6 → 2.7.0-alpha.1

package/dist/animation/animation-clip.d.ts

@@ -0,0 +1,44 @@
+import type { Euler } from '@galacean/effects-math/es/core/euler';
+import type { Quaternion } from '@galacean/effects-math/es/core/quaternion';
+import * as spec from '@galacean/effects-specification';
+import { EffectsObject } from '../effects-object';
+import type { ValueGetter, Vector3Curve, BezierCurve, ColorCurve } from '../math';
+import type { VFXItem } from '../vfx-item';
+export interface AnimationCurve {
+    path: string;
+    keyFrames: ValueGetter<any>;
+}
+export interface PositionAnimationCurve extends AnimationCurve {
+    keyFrames: Vector3Curve;
+}
+export interface EulerAnimationCurve extends AnimationCurve {
+    keyFrames: ValueGetter<Euler>;
+}
+export interface RotationAnimationCurve extends AnimationCurve {
+    keyFrames: ValueGetter<Quaternion>;
+}
+export interface ScaleAnimationCurve extends AnimationCurve {
+    keyFrames: Vector3Curve;
+}
+export interface FloatAnimationCurve extends AnimationCurve {
+    property: string;
+    className: string;
+    keyFrames: BezierCurve;
+}
+export interface ColorAnimationCurve extends AnimationCurve {
+    property: string;
+    className: string;
+    keyFrames: ColorCurve;
+}
+export declare class AnimationClip extends EffectsObject {
+    duration: number;
+    positionCurves: PositionAnimationCurve[];
+    rotationCurves: RotationAnimationCurve[];
+    eulerCurves: EulerAnimationCurve[];
+    scaleCurves: ScaleAnimationCurve[];
+    floatCurves: FloatAnimationCurve[];
+    colorCurves: ColorAnimationCurve[];
+    sampleAnimation(vfxItem: VFXItem, time: number): void;
+    fromData(data: spec.AnimationClipData): void;
+    private findTarget;
+}

package/dist/animation/color-playable.d.ts

@@ -1,11 +1,11 @@
 import * as spec from '@galacean/effects-specification';
 import { type ValueGetter } from '../math';
-import type { FrameContext } from '../plugins/cal/playable-graph';
-import { Playable } from '../plugins/cal/playable-graph';
+import type { FrameContext } from '../plugins/timeline/playable';
+import { Playable } from '../plugins/timeline/playable';
 import { VFXItem } from '../vfx-item';
 import type { Material } from '../material';
 import type { ColorStop } from '../utils';
-import { BaseRenderComponent } from '../components';
+import { MaskableGraphic } from '../components';
 export interface ColorPlayableAssetData extends spec.EffectsObjectData {
     colorOverLifetime?: spec.ColorOverLifetime;
 }
@@ -18,9 +18,9 @@ export declare class ColorPlayable extends Playable {
     opacityOverLifetime: ValueGetter<number>;
     startColor: spec.RGBAColorValue;
     renderColor: spec.vec4;
-    activeComponent?: BaseRenderComponent;
+    activeComponent?: MaskableGraphic;
     activeMaterial?: Material;
     processFrame(context: FrameContext): void;
     create(clipData: ColorPlayableAssetData): this;
-    getActiveComponent(boundObject: VFXItem): BaseRenderComponent;
+    getActiveComponent(boundObject: VFXItem): MaskableGraphic;
 }

package/dist/animation/index.d.ts

@@ -1 +1,2 @@
 export * from './color-playable';
+export * from './animation-clip';

package/dist/asset-manager.d.ts

@@ -1,3 +1,4 @@
+import * as spec from '@galacean/effects-specification';
 import { Downloader } from './downloader';
 import type { ImageLike, SceneLoadOptions } from './scene';
 import { Scene } from './scene';
@@ -36,6 +37,13 @@ export declare class AssetManager implements Disposable {
      * 场景加载的超时定时器
      */
     private timers;
+    /**
+     * 字体加载方法
+     * @param fonts - 字体定义数组
+     * @param [baseURL=location.href] - URL 的 base 字段
+     * @returns
+     */
+    static loadFontFamily(fonts: spec.FontDefine[], baseURL?: string): Promise<void[] | undefined>;
     /**
      * 构造函数
      * @param options - 场景加载参数

package/dist/comp-vfx-item.d.ts

@@ -1,5 +1,5 @@
 import type { Ray } from '@galacean/effects-math/es/core/ray';
-import * as spec from '@galacean/effects-specification';
+import type * as spec from '@galacean/effects-specification';
 import { Component } from './components';
 import type { CompositionHitTestOptions } from './composition';
 import type { Region, TrackAsset } from './plugins';
@@ -21,10 +21,8 @@ export declare class CompositionComponent extends Component {
     private reusable;
     private sceneBindings;
     private timelineAsset;
-    private timelinePlayable;
-    private graph;
+    private timelineInstance;
     onStart(): void;
-    setReusable(value: boolean): void;
     getReusable(): boolean;
     pause(): void;
     resume(): void;
@@ -34,6 +32,4 @@ export declare class CompositionComponent extends Component {
     onDestroy(): void;
     hitTest(ray: Ray, x: number, y: number, regions: Region[], force?: boolean, options?: CompositionHitTestOptions): Region[];
     fromData(data: any): void;
-    private resolveBindings;
-    private updateTrackAnimatedObject;
 }

package/dist/components/animator.d.ts

@@ -1,14 +1,44 @@
 import type * as spec from '@galacean/effects-specification';
+import type { StateMachineNode } from '../plugins/animation-graph';
 import { Component } from './component.js';
 /**
  * @since 2.6.0
  */
 export declare class Animator extends Component {
     private graphAsset;
+    /**
+     * 设置布尔类型参数
+     * @param name - 参数名
+     * @param value - 参数值
+     * @since 2.7.0
+     */
     setBool(name: string, value: boolean): void;
+    /**
+     * 设置浮点类型参数
+     * @param name - 参数名
+     * @param value - 参数值
+     * @since 2.7.0
+     */
     setFloat(name: string, value: number): void;
+    /**
+     * 设置触发器参数
+     * @since 2.7.0
+     * @param name - 参数名
+     */
     setTrigger(name: string): void;
+    /**
+     * 重置触发器参数
+     * @since 2.7.0
+     * @param name - 参数名
+     */
     resetTrigger(name: string): void;
+    /**
+     * 获取状态机节点
+     * @param machineName - 状态机名称
+     * @since 2.7.0
+     * @returns 状态机节点
+     */
+    getStateMachineNode(machineName: string): StateMachineNode | null;
     onStart(): void;
     onUpdate(dt: number): void;
     fromData(data: spec.AnimatorData): void;

package/dist/components/base-render-component.d.ts

@@ -3,11 +3,10 @@ import * as spec from '@galacean/effects-specification';
 import type { Engine } from '../engine';
 import type { Maskable } from '../material';
 import { MaskProcessor } from '../material';
-import type { BoundingBoxTriangle, HitTestTriangleParams, splitsDataType } from '../plugins';
+import type { BoundingBoxTriangle, HitTestTriangleParams } from '../plugins';
 import { MeshCollider } from '../plugins';
 import type { Renderer } from '../render';
 import { Geometry } from '../render';
-import { type GeometryFromShape } from '../shape';
 import { Texture } from '../texture';
 import { RendererComponent } from './renderer-component';
 /**
@@ -16,27 +15,24 @@ import { RendererComponent } from './renderer-component';
 export interface ItemRenderer extends Required<Omit<spec.RendererOptions, 'texture' | 'shape' | 'anchor' | 'particleOrigin' | 'mask'>> {
     texture: Texture;
     mask: number;
-    shape?: GeometryFromShape;
 }
 /**
- * @since 2.1.0
+ * @since 2.7.0
  */
-export declare class BaseRenderComponent extends RendererComponent implements Maskable {
+export declare class MaskableGraphic extends RendererComponent implements Maskable {
     interaction?: {
         behavior: spec.InteractBehavior;
     };
     renderer: ItemRenderer;
     geometry: Geometry;
     protected visible: boolean;
-    protected splits: splitsDataType;
-    protected textureSheetAnimation?: spec.TextureSheetAnimation;
     protected readonly maskManager: MaskProcessor;
     /**
      * 用于点击测试的碰撞器
      */
     protected meshCollider: MeshCollider;
+    protected defaultGeometry: Geometry;
     private _color;
-    private defaultGeometry;
     /**
      *
      * @param engine
@@ -93,8 +89,6 @@ export declare class BaseRenderComponent extends RendererComponent implements Ma
     onStart(): void;
     getHitTestParams: (force?: boolean) => HitTestTriangleParams | undefined;
     getBoundingBox(): BoundingBoxTriangle;
-    private getItemGeometryData;
-    private configureDefaultGeometry;
     private configureMaterial;
     private draw;
     fromData(data: unknown): void;

package/dist/components/component.d.ts

@@ -51,6 +51,10 @@ export declare abstract class Component extends EffectsObject {
      * 生命周期函数，在组件销毁时调用
      */
     onDestroy(): void;
+    /**
+     * 当属性被动画修改时调用
+     */
+    onApplyAnimationProperties(): void;
     setVFXItem(item: VFXItem): void;
     fromData(data: any): void;
     dispose(): void;

package/dist/components/shape-component.d.ts

@@ -1,20 +1,53 @@
+import { Color } from '@galacean/effects-math/es/core/color';
+import { Vector2 } from '@galacean/effects-math/es/core/vector2';
 import * as spec from '@galacean/effects-specification';
 import type { Engine } from '../engine';
-import { BaseRenderComponent } from './base-render-component';
-interface ShapeAttribute {
+import type { Maskable } from '../material';
+import type { BoundingBoxTriangle, HitTestTriangleParams } from '../plugins';
+import type { Renderer } from '../render';
+import type { GradientValue } from '../math';
+import { RendererComponent } from './renderer-component';
+import type { Texture } from '../texture/texture';
+export declare enum FillType {
+    Solid = 0,
+    GradientLinear = 1,
+    GradientRadial = 2,
+    GradientAngular = 3,
+    Texture = 4
+}
+export interface SolidPaint {
+    type: FillType.Solid;
+    color: Color;
+}
+export interface GradientPaint {
+    type: FillType.GradientLinear | FillType.GradientAngular | FillType.GradientRadial;
+    gradientStops: GradientValue;
+    startPoint: Vector2;
+    endPoint: Vector2;
+}
+export interface TexturePaint {
+    type: FillType.Texture;
+    texture: Texture;
+    scaleMode: TexturePaintScaleMode;
+    scalingFactor: number;
+    opacity: number;
+}
+export declare enum TexturePaintScaleMode {
+    Fill = 0,
+    Fit = 1,
+    Crop = 2,
+    Tile = 3
+}
+interface ShapeAttributes {
     /**
      * 矢量图形类型
      */
     type: spec.ShapePrimitiveType;
-    /**
-     * 填充属性
-     */
-    fill?: spec.ShapeFillParam;
 }
 /**
  * 椭圆组件参数
  */
-export interface EllipseAttribute extends ShapeAttribute {
+export interface EllipseAttribute extends ShapeAttributes {
     type: spec.ShapePrimitiveType.Ellipse;
     /**
      * x 轴半径
@@ -30,7 +63,7 @@ export interface EllipseAttribute extends ShapeAttribute {
 /**
  * 矩形参数
  */
-export interface RectangleAttribute extends ShapeAttribute {
+export interface RectangleAttribute extends ShapeAttributes {
     /**
      * 宽度
      */
@@ -47,7 +80,7 @@ export interface RectangleAttribute extends ShapeAttribute {
 /**
  * 星形参数
  */
-export interface StarAttribute extends ShapeAttribute {
+export interface StarAttribute extends ShapeAttributes {
     /**
      * 顶点数 - 内外顶点同数
      */
@@ -72,7 +105,7 @@ export interface StarAttribute extends ShapeAttribute {
 /**
  * 多边形参数
  */
-export interface PolygonAttribute extends ShapeAttribute {
+export interface PolygonAttribute extends ShapeAttributes {
     /**
      * 顶点数
      */
@@ -90,17 +123,24 @@ export interface PolygonAttribute extends ShapeAttribute {
  * 图形组件
  * @since 2.1.0
  */
-export declare class ShapeComponent extends BaseRenderComponent {
+export declare class ShapeComponent extends RendererComponent implements Maskable {
     private hasStroke;
     private hasFill;
     private shapeDirty;
+    private materialDirty;
     private graphicsPath;
-    private fillAttribute;
+    private fills;
     private strokeAttributes;
-    private shapeAttribute;
-    private vert;
-    private frag;
-    get shape(): ShapeAttribute;
+    private strokes;
+    private shapeAttributes;
+    /**
+     * 用于点击测试的碰撞器
+     */
+    private meshCollider;
+    private renderer;
+    private geometry;
+    private readonly maskManager;
+    get shape(): ShapeAttributes;
     /**
      *
      * @param engine
@@ -108,8 +148,47 @@ export declare class ShapeComponent extends BaseRenderComponent {
     constructor(engine: Engine);
     onStart(): void;
     onUpdate(dt: number): void;
+    render(renderer: Renderer): void;
+    private draw;
+    getHitTestParams: (force?: boolean) => HitTestTriangleParams | undefined;
+    getBoundingBox(): BoundingBoxTriangle;
     private buildGeometryFromPath;
     private buildPath;
+    private updateMaterials;
+    private updatePaintMaterial;
+    private updateGradientMaterial;
     fromData(data: spec.ShapeComponentData): void;
+    private createPaint;
+    onApplyAnimationProperties(): void;
+}
+export type PaintData = SolidPaintData | GradientPaintData | TexturePaintData;
+export interface SolidPaintData {
+    type: FillType.Solid;
+    /**
+     * 填充颜色
+     */
+    color: spec.ColorData;
+}
+export interface GradientPaintData {
+    type: FillType.GradientLinear | FillType.GradientAngular | FillType.GradientRadial;
+    /**
+     * 渐变颜色
+     */
+    gradientStops: spec.GradientColor;
+    /**
+     * 渐变起点
+     */
+    startPoint: spec.Vector2Data;
+    /**
+     * 渐变终点
+     */
+    endPoint: spec.Vector2Data;
+}
+export interface TexturePaintData {
+    type: FillType.Texture;
+    texture: spec.DataPath;
+    scaleMode: TexturePaintScaleMode;
+    scalingFactor?: number;
+    opacity?: number;
 }
 export {};

package/dist/composition.d.ts

@@ -146,10 +146,6 @@ export declare class Composition extends EventEmitter<CompositionEvent<Compositi
      * 播放完成后是否需要再使用，是的话生命周期结束后不会自动 dispose
      */
     reusable: boolean;
-    /**
-     * 是否播放完成后销毁 texture 对象
-     */
-    keepResource: boolean;
     /**
      * 合成内的元素否允许点击、拖拽交互
      * @since 1.6.0

package/dist/downloader.d.ts

@@ -21,6 +21,12 @@ export type JSONValue = string | number | boolean | {
  * 负责下载各种资源，并提供了一些异步加载和缓存管理的功能
  */
 export declare class Downloader {
+    /**
+     * 是否信任 XMLHttpRequest 的状态码为 0 的响应
+     * 某些浏览器在本地文件协议（file://）下会返回状态码 0，但实际上请求是成功的
+     * 设置为 true 可以让 Downloader 将状态码 0 视为成功
+     */
+    static trustXHRStatusZero: boolean;
     /**
      * 存储多个回调函数的对象
      */

package/dist/fallback/migration.d.ts

@@ -15,6 +15,7 @@ export declare function version22Migration(json: JSONSceneLegacy): JSONSceneLega
 export declare function version31Migration(json: JSONScene): JSONScene;
 export declare function version32Migration(json: JSONScene): JSONScene;
 export declare function version33Migration(json: JSONScene): JSONScene;
+export declare function version34Migration(json: JSONScene): JSONScene;
 export declare function processContent(composition: spec.CompositionData): void;
 export declare function processMask(renderContent: any): void;
 /**

package/dist/index.d.ts

@@ -9,6 +9,7 @@ export * from './camera';
 export * from './canvas-pool';
 export * from './comp-vfx-item';
 export * from './components';
+export * from './animation';
 export * from './composition';
 export * from './config';
 export * from './constants';