@galacean/effects-core 2.1.0-alpha.6 → 2.1.0-alpha.8

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

@@ -0,0 +1,26 @@
+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 { VFXItem } from '../vfx-item';
+import type { Material } from '../material';
+import type { ColorStop } from '../utils';
+import { BaseRenderComponent } from '../components';
+export interface ColorPlayableAssetData extends spec.EffectsObjectData {
+    colorOverLifetime?: spec.ColorOverLifetime;
+}
+export declare class ColorPlayable extends Playable {
+    clipData: {
+        colorOverLifetime?: spec.ColorOverLifetime;
+        startColor?: spec.RGBAColorValue;
+    };
+    colorOverLifetime: ColorStop[];
+    opacityOverLifetime: ValueGetter<number>;
+    startColor: spec.RGBAColorValue;
+    renderColor: spec.vec4;
+    activeComponent?: BaseRenderComponent;
+    activeMaterial?: Material;
+    processFrame(context: FrameContext): void;
+    create(clipData: ColorPlayableAssetData): this;
+    getActiveComponent(boundObject: VFXItem): BaseRenderComponent;
+}

package/dist/animation/index.d.ts

@@ -0,0 +1 @@
+export * from './color-playable';

package/dist/asset-manager.d.ts

@@ -18,10 +18,14 @@ export declare class AssetManager implements Disposable {
      * 图像资源，用于创建和释放 GPU 纹理资源
      */
     private assets;
+    /**
+     * TextureSource 来源
+     */
+    private sourceFrom;
     /**
      * 自定义文本缓存，随页面销毁而销毁
      */
-    static fonts: Set<string>;
+    private static fontCache;
     private id;
     /**
      * 加载超时时间
@@ -54,9 +58,12 @@ export declare class AssetManager implements Disposable {
     private processBins;
     private processFontURL;
     private processImages;
+    private processPluginAssets;
+    private prepareAssets;
     private processTextures;
     private loadJSON;
     private loadBins;
+    private assignImagesToAssets;
     private removeTimer;
     /**
      * 销毁方法

package/dist/asset.d.ts

@@ -0,0 +1,4 @@
+import { EffectsObject } from './effects-object';
+export declare class Asset<T> extends EffectsObject {
+    data: T;
+}

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

@@ -2,7 +2,6 @@ import type { Ray } from '@galacean/effects-math/es/core/ray';
 import * as spec from '@galacean/effects-specification';
 import { Behaviour } from './components';
 import type { CompositionHitTestOptions } from './composition';
-import type { ContentOptions } from './composition-source-manager';
 import type { Region, TrackAsset } from './plugins';
 import { VFXItem } from './vfx-item';
 export interface SceneBinding {
@@ -19,9 +18,7 @@ export interface SceneBindingData {
 export declare class CompositionComponent extends Behaviour {
     time: number;
     startTime: number;
-    refId: string;
     items: VFXItem[];
-    data: ContentOptions;
     private reusable;
     private sceneBindings;
     private timelineAsset;
@@ -36,7 +33,7 @@ export declare class CompositionComponent extends Behaviour {
     hideItems(): void;
     onDestroy(): void;
     hitTest(ray: Ray, x: number, y: number, regions: Region[], force?: boolean, options?: CompositionHitTestOptions): Region[];
-    fromData(data: unknown): void;
+    fromData(data: any): void;
     private resolveBindings;
-    private resolveTrackBindingsWithRoot;
+    private updateTrackAnimatedObject;
 }

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

@@ -0,0 +1,99 @@
+import * as spec from '@galacean/effects-specification';
+import { Matrix4 } from '@galacean/effects-math/es/core/matrix4';
+import { RendererComponent } from './renderer-component';
+import type { Texture } from '../texture';
+import type { GeometryDrawMode, Renderer } from '../render';
+import { Geometry } from '../render';
+import type { Engine } from '../engine';
+import type { BoundingBoxTriangle, HitTestTriangleParams } from '../plugins';
+import { Material } from '../material';
+/**
+ * 图层元素渲染属性, 经过处理后的 spec.SpriteContent.renderer
+ */
+export interface ItemRenderer extends Required<Omit<spec.RendererOptions, 'texture' | 'shape' | 'anchor' | 'particleOrigin'>> {
+    order: number;
+    mask: number;
+    texture: Texture;
+    anchor?: spec.vec2;
+    particleOrigin?: spec.ParticleOrigin;
+}
+/**
+ * 图层的渲染属性，用于 Mesh 的合并判断
+ */
+export interface ItemRenderInfo {
+    side: number;
+    occlusion: boolean;
+    blending: number;
+    cachePrefix: string;
+    mask: number;
+    maskMode: number;
+    cacheId: string;
+    wireframe?: boolean;
+}
+export declare class BaseRenderComponent extends RendererComponent {
+    interaction?: {
+        behavior: spec.InteractBehavior;
+    };
+    cachePrefix: string;
+    geoData: {
+        atlasOffset: number[] | spec.TypedArray;
+        index: number[] | spec.TypedArray;
+    };
+    anchor?: spec.vec2;
+    renderer: ItemRenderer;
+    emptyTexture: Texture;
+    color: spec.vec4;
+    worldMatrix: Matrix4;
+    geometry: Geometry;
+    protected renderInfo: ItemRenderInfo;
+    protected readonly wireframe?: boolean;
+    protected preMultiAlpha: number;
+    protected visible: boolean;
+    protected isManualTimeSet: boolean;
+    protected frameAnimationTime: number;
+    constructor(engine: Engine);
+    /**
+     * 设置当前 Mesh 的可见性。
+     * @param visible - true：可见，false：不可见
+     */
+    setVisible(visible: boolean): void;
+    /**
+     * 获取当前 Mesh 的可见性。
+     */
+    getVisible(): boolean;
+    /**
+     * 设置当前图层的颜色
+     * > Tips: 透明度也属于颜色的一部分，当有透明度/颜色 K 帧变化时，该 API 会失效
+     * @since 2.0.0
+     * @param color - 颜色值
+     */
+    setColor(color: spec.vec4): void;
+    /**
+     * 设置当前 Mesh 的纹理
+     * @since 2.0.0
+     * @param texture - 纹理对象
+     */
+    setTexture(texture: Texture): void;
+    render(renderer: Renderer): void;
+    onStart(): void;
+    onDestroy(): void;
+    protected getItemInitData(): {
+        atlasOffset: spec.TypedArray | number[];
+        index: number[];
+    };
+    protected setItem(): void;
+    protected getItemGeometryData(): {
+        index: number[];
+        atlasOffset: number[];
+    };
+    protected createGeometry(mode: GeometryDrawMode): Geometry;
+    protected createMaterial(renderInfo: ItemRenderInfo, count: number): Material;
+    getTextures(): Texture[];
+    /**
+     * 获取图层包围盒的类型和世界坐标
+     * @returns
+     */
+    getBoundingBox(): BoundingBoxTriangle | void;
+    getHitTestParams: (force?: boolean) => HitTestTriangleParams | undefined;
+}
+export declare function getImageItemRenderInfo(item: BaseRenderComponent): ItemRenderInfo;

package/dist/components/index.d.ts

@@ -2,4 +2,5 @@ export * from './renderer-component';
 export * from './component';
 export * from './effect-component';
 export * from './post-process-volume';
+export * from './base-render-component';
 export * from './shape-component';

package/dist/components/post-process-volume.d.ts

@@ -1,7 +1,6 @@
 import { Behaviour } from './component';
 export declare class PostProcessVolume extends Behaviour {
-    useHDR: boolean;
-    useBloom: boolean;
+    bloomEnabled: boolean;
     threshold: number;
     bloomIntensity: number;
     brightness: number;
@@ -10,6 +9,6 @@ export declare class PostProcessVolume extends Behaviour {
     vignetteIntensity: number;
     vignetteSmoothness: number;
     vignetteRoundness: number;
-    useToneMapping: boolean;
+    toneMappingEnabled: boolean;
     onStart(): void;
 }

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

@@ -1,7 +1,5 @@
 import type * as spec from '@galacean/effects-specification';
 import type { Engine } from '../engine';
-import { GraphicsPath } from '../plugins/shape/graphics-path';
-import type { ShapePath } from '../plugins/shape/shape-path';
 import type { Renderer } from '../render';
 import { RendererComponent } from './renderer-component';
 /**
@@ -9,17 +7,19 @@ import { RendererComponent } from './renderer-component';
  * @since 2.1.0
  */
 export declare class ShapeComponent extends RendererComponent {
-    path: GraphicsPath;
+    private path;
     private curveValues;
     private geometry;
-    private dirty;
+    private data;
+    private animated;
     private vert;
     private frag;
     constructor(engine: Engine);
     onUpdate(dt: number): void;
     render(renderer: Renderer): void;
-    buildGeometryFromPath(shapePath: ShapePath): void;
-    fromData(data: ShapeCustomComponent): void;
+    private buildGeometryFromPath;
+    private buildPath;
+    fromData(data: ShapeComponentData): void;
 }
 /************************** Test Interface **********************************/
 /**
@@ -170,3 +170,37 @@ export declare enum ShapeConnectType {
 }
 export declare enum ShapePointType {
 }
+/**
+ * @description 椭圆组件参数
+ */
+export interface ShapeEllipseComponent extends ShapeComponentData {
+    type: ComponentShapeType.ELLIPSE;
+    param: ShapeEllipseParam;
+}
+/**
+ * @description 椭圆参数
+ */
+export interface ShapeEllipseParam {
+    /**
+     * @description x轴半径
+     * -- TODO 后续完善类型
+     * -- TODO 可以看一下用xRadius/yRadius 还是 width/height
+     */
+    xRadius: number;
+    /**
+     * @description y轴半径
+     */
+    yRadius: number;
+    /**
+     * 填充属性
+     */
+    fill?: ShapeFillParam;
+    /**
+     * 描边属性
+     */
+    stroke?: ShapeStrokeParam;
+    /**
+     * 空间变换
+     */
+    transform?: spec.TransformData;
+}

package/dist/composition/scene-ticking.d.ts

@@ -1,4 +1,4 @@
-import { Component } from '../components/component';
+import { Component } from '../components';
 export declare class SceneTicking {
     update: UpdateTickData;
     lateUpdate: LateUpdateTickData;

package/dist/composition-source-manager.d.ts

@@ -5,13 +5,12 @@ import type { PluginSystem } from './plugin-system';
 import type { Scene, SceneRenderLevel } from './scene';
 import type { Texture } from './texture';
 import type { Disposable } from './utils';
-import type { VFXItemProps } from './vfx-item';
 export interface ContentOptions {
     id: string;
     duration: number;
     name: string;
     endBehavior: spec.EndBehavior;
-    items: VFXItemProps[];
+    items: spec.DataPath[];
     camera: spec.CameraOptions;
     startTime: number;
     timelineAsset: spec.DataPath;
@@ -22,9 +21,8 @@ export interface ContentOptions {
  */
 export declare class CompositionSourceManager implements Disposable {
     composition?: spec.CompositionData;
-    refCompositions: Map<string, spec.CompositionData>;
-    sourceContent?: ContentOptions;
-    refCompositionProps: Map<string, VFXItemProps>;
+    sourceContent?: spec.CompositionData;
+    refCompositionProps: Map<string, spec.CompositionData>;
     renderLevel?: SceneRenderLevel;
     pluginSystem?: PluginSystem;
     totalTime: number;
@@ -33,6 +31,7 @@ export declare class CompositionSourceManager implements Disposable {
     jsonScene?: spec.JSONScene;
     mask: number;
     engine: Engine;
+    private refCompositions;
     constructor(scene: Scene, engine: Engine);
     private getContent;
     private assembleItems;

package/dist/composition.d.ts

@@ -12,11 +12,10 @@ import { RenderFrame } from './render';
 import type { Scene } from './scene';
 import type { Texture } from './texture';
 import type { Disposable, LostHandler } from './utils';
-import type { VFXItemProps } from './vfx-item';
 import { VFXItem } from './vfx-item';
 import type { CompositionEvent } from './events';
 import { EventEmitter } from './events';
-import type { PostProcessVolume } from './components/post-process-volume';
+import type { PostProcessVolume } from './components';
 import { SceneTicking } from './composition/scene-ticking';
 export interface CompositionStatistic {
     loadStart: number;
@@ -93,7 +92,6 @@ export declare class Composition extends EventEmitter<CompositionEvent<Compositi
      * 是否播放完成后销毁 texture 对象
      */
     keepResource: boolean;
-    extraCamera: VFXItem;
     /**
      * 合成内的元素否允许点击、拖拽交互
      * @since 1.6.0
@@ -151,7 +149,7 @@ export declare class Composition extends EventEmitter<CompositionEvent<Compositi
     /**
      * 预合成的合成属性，在 content 中会被其元素属性覆盖
      */
-    refCompositionProps: Map<string, VFXItemProps>;
+    refCompositionProps: Map<string, spec.CompositionData>;
     /**
      * 合成的相机对象
      */
@@ -159,7 +157,11 @@ export declare class Composition extends EventEmitter<CompositionEvent<Compositi
     /**
      * 后处理渲染配置
      */
-    globalVolume: PostProcessVolume;
+    globalVolume?: PostProcessVolume;
+    /**
+     * 是否开启后处理
+     */
+    postProcessingEnabled: boolean;
     protected rendererOptions: MeshRendererOptions | null;
     protected assigned: boolean;
     /**
@@ -189,7 +191,6 @@ export declare class Composition extends EventEmitter<CompositionEvent<Compositi
      * @param compositionSourceManager
      */
     constructor(props: CompositionProps, scene: Scene);
-    initializeSceneTicking(item: VFXItem): void;
     /**
      * 所有合成 Item 的根变换
      */
@@ -296,7 +297,6 @@ export declare class Composition extends EventEmitter<CompositionEvent<Compositi
      * @param deltaTime - 更新的时间步长
      */
     update(deltaTime: number): void;
-    private toLocalTime;
     private shouldDispose;
     private getUpdateTime;
     private callAwake;
@@ -304,7 +304,6 @@ export declare class Composition extends EventEmitter<CompositionEvent<Compositi
      * 构建父子树，同时保存到 itemCacheMap 中便于查找
      */
     private buildItemTree;
-    private getParentIdWithoutSuffix;
     /**
      * 更新视频数据到纹理
      * @override

package/dist/downloader.d.ts

@@ -1,8 +1,5 @@
 type SuccessHandler<T> = (data: T) => void;
 type ErrorHandler = (status: number, responseText: string) => void;
-/**
- *
- */
 /**
  * JSON 值，它可以是字符串、数字、布尔值、对象或者 JSON 值的数组。
  *

package/dist/index.d.ts

@@ -1,5 +1,7 @@
 export * as math from '@galacean/effects-math/es/core/index';
 export * as spec from '@galacean/effects-specification';
+export * from './asset';
+export * from './binary-asset';
 export * from './asset-loader';
 export * from './asset-manager';
 export * from './camera';
@@ -32,8 +34,8 @@ export * from './ticker';
 export * from './transform';
 export * from './utils';
 export * from './vfx-item';
-export * from './binary-asset';
 export * from './effects-object';
 export * from './effects-package';
 export * from './events';
+export * from './pass-render-level';
 export declare const version: string;