@galacean/effects-core 2.0.0-alpha.8 → 2.0.0-beta.0

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

@@ -6,7 +6,7 @@ import { Component } from './component';
  * @since 2.0.0
  */
 export declare class RendererComponent extends Component {
-    started: boolean;
+    isStartCalled: boolean;
     materials: Material[];
     protected _priority: number;
     protected _enabled: boolean;
@@ -26,7 +26,7 @@ export declare class RendererComponent extends Component {
     lateUpdate(dt: number): void;
     render(renderer: Renderer): void;
     onAttached(): void;
-    fromData(data: any): void;
+    fromData(data: unknown): void;
     toData(): void;
     dispose(): void;
 }

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

@@ -1,8 +1,8 @@
 import * as spec from '@galacean/effects-specification';
+import type { SceneBindingData } from './comp-vfx-item';
 import type { Engine } from './engine';
 import type { PluginSystem } from './plugin-system';
-import type { GlobalVolume } from './render';
-import type { Scene } from './scene';
+import type { Scene, SceneRenderLevel } from './scene';
 import type { Texture } from './texture';
 import type { Disposable } from './utils';
 import type { VFXItemProps } from './vfx-item';
@@ -10,21 +10,22 @@ export interface ContentOptions {
     id: string;
     duration: number;
     name: string;
-    endBehavior: spec.CompositionEndBehavior;
+    endBehavior: spec.EndBehavior;
     items: VFXItemProps[];
     camera: spec.CameraOptions;
     startTime: number;
-    globalVolume: GlobalVolume;
+    timelineAsset: spec.DataPath;
+    sceneBindings: SceneBindingData[];
 }
 /**
  * 合成资源管理
  */
 export declare class CompositionSourceManager implements Disposable {
-    composition?: spec.Composition;
-    refCompositions: Map<string, spec.Composition>;
+    composition?: spec.CompositionData;
+    refCompositions: Map<string, spec.CompositionData>;
     sourceContent?: ContentOptions;
     refCompositionProps: Map<string, VFXItemProps>;
-    renderLevel?: spec.RenderLevel;
+    renderLevel?: SceneRenderLevel;
     pluginSystem?: PluginSystem;
     totalTime: number;
     imgUsage: Record<string, number[]>;

package/dist/composition.d.ts

@@ -1,23 +1,27 @@
-import type { Ray } from '@galacean/effects-math/es/core/index';
 import * as spec from '@galacean/effects-specification';
+import type { Ray } from '@galacean/effects-math/es/core/ray';
+import type { Vector3 } from '@galacean/effects-math/es/core/vector3';
+import type { Matrix4 } from '@galacean/effects-math/es/core/matrix4';
 import { Camera } from './camera';
 import { CompositionComponent } from './comp-vfx-item';
-import type { CompositionSourceManager } from './composition-source-manager';
+import { CompositionSourceManager } from './composition-source-manager';
 import type { PluginSystem } from './plugin-system';
-import type { EventSystem, Region } from './plugins';
+import type { EventSystem, Plugin, Region } from './plugins';
 import type { MeshRendererOptions, Renderer } from './render';
 import { RenderFrame } from './render';
-import type { Scene } from './scene';
+import type { Scene, SceneType } from './scene';
 import type { Texture } from './texture';
-import { Transform } from './transform';
 import type { Disposable, LostHandler } from './utils';
-import type { VFXItemContent, VFXItemProps } from './vfx-item';
+import type { VFXItemProps } from './vfx-item';
 import { VFXItem } from './vfx-item';
-import type { SceneType } from './asset-manager';
+import type { CompositionEvent } from './events';
+import { EventEmitter } from './events';
+import type { PostProcessVolume } from './components/post-process-volume';
 export interface CompositionStatistic {
     loadTime: number;
     loadStart: number;
     firstFrameTime: number;
+    precompileTime: number;
 }
 export interface MessageItem {
     id: string;
@@ -25,21 +29,25 @@ export interface MessageItem {
     phrase: number;
     compositionId: string;
 }
+export interface CompItemClickedData {
+    name: string;
+    id: string;
+    hitPositions: Vector3[];
+    position: Vector3;
+}
 /**
  *
  */
 export interface CompositionHitTestOptions {
     maxCount?: number;
     stop?: (region: Region) => boolean;
-    skip?: (item: VFXItem<VFXItemContent>) => boolean;
+    skip?: (item: VFXItem) => boolean;
 }
 export interface CompositionProps {
     reusable?: boolean;
     baseRenderOrder?: number;
     renderer: Renderer;
-    onPlayerPause?: (item: VFXItem<any>) => void;
-    onMessageItem?: (item: MessageItem) => void;
-    onEnd?: (composition: Composition) => void;
+    handleItemMessage: (message: MessageItem) => void;
     event?: EventSystem;
     width: number;
     height: number;
@@ -50,8 +58,7 @@ export interface CompositionProps {
  * 合成中包含了相关的 Item 元素，支持对 Item 元素的创建、更新和销毁。
  * 也负责 Item 相关的动画播放控制，和持有渲染帧数据。
  */
-export declare class Composition implements Disposable, LostHandler {
-    compositionSourceManager: CompositionSourceManager;
+export declare class Composition extends EventEmitter<CompositionEvent<Composition>> implements Disposable, LostHandler {
     renderer: Renderer;
     /**
      * 当前帧的渲染数据对象
@@ -70,10 +77,6 @@ export declare class Composition implements Disposable, LostHandler {
      * 合成渲染顺序，默认按升序渲染
      */
     renderOrder: number;
-    /**
-     * 所有合成 Item 的根变换
-     */
-    transform: Transform;
     /**
      * 播放完成后是否需要再使用，是的话生命周期结束后不会自动 dispose
      */
@@ -82,20 +85,13 @@ export declare class Composition implements Disposable, LostHandler {
      * 是否播放完成后销毁 texture 对象
      */
     keepResource: boolean;
-    extraCamera: VFXItem<VFXItemContent>;
-    /**
-     * 合成结束行为是 spec.END_BEHAVIOR_PAUSE 或 spec.END_BEHAVIOR_PAUSE_AND_DESTROY 时执行的回调
-     * @internal
-     */
-    onPlayerPause?: (item: VFXItem<any>) => void;
+    extraCamera: VFXItem;
     /**
-     * 单个合成结束时的回调
+     * 合成内的元素否允许点击、拖拽交互
+     * @since 1.6.0
      */
-    onEnd?: (composition: Composition) => void;
-    /**
-     * 合成中消息元素创建/销毁时触发的回调
-     */
-    onMessageItem?: (item: MessageItem) => void;
+    interactive: boolean;
+    compositionSourceManager: CompositionSourceManager;
     /**
      * 合成id
      */
@@ -128,10 +124,6 @@ export declare class Composition implements Disposable, LostHandler {
      * 用于保存与当前合成相关的插件数据
      */
     readonly loaderData: Record<string, any>;
-    /**
-     * 渲染等级：S，A+，A，B+，B
-     */
-    readonly renderLevel?: spec.RenderLevel;
     /**
      * 场景加载和首帧渲染时间
      */
@@ -143,11 +135,11 @@ export declare class Composition implements Disposable, LostHandler {
     /**
      * 合成根元素
      */
-    rootItem: VFXItem<VFXItemContent>;
+    readonly rootItem: VFXItem;
     /**
      * 预合成数组
      */
-    readonly refContent: VFXItem<VFXItemContent>[];
+    readonly refContent: VFXItem[];
     /**
      * 预合成的合成属性，在 content 中会被其元素属性覆盖
      */
@@ -160,6 +152,10 @@ export declare class Composition implements Disposable, LostHandler {
      * 合成全局时间
      */
     globalTime: number;
+    /**
+     * 后处理渲染配置
+     */
+    globalVolume: PostProcessVolume;
     protected rendererOptions: MeshRendererOptions | null;
     protected assigned: boolean;
     /**
@@ -171,31 +167,28 @@ export declare class Composition implements Disposable, LostHandler {
      */
     protected readonly keepColorBuffer: boolean;
     protected rootComposition: CompositionComponent;
+    protected readonly postLoaders: Plugin[];
     /**
      * 合成暂停/播放 标识
      */
     private paused;
     private lastVideoUpdateTime;
+    private readonly texInfo;
     /**
-     * 后处理渲染配置
+     * 合成中消息元素创建/销毁时触发的回调
      */
-    private readonly globalVolume;
-    private readonly texInfo;
-    private readonly postLoaders;
-    private rootTimeline;
+    private handleItemMessage;
     /**
      * Composition 构造函数
      * @param props - composition 的创建参数
      * @param scene
      * @param compositionSourceManager
      */
-    constructor(props: CompositionProps, scene: Scene, compositionSourceManager: CompositionSourceManager);
+    constructor(props: CompositionProps, scene: Scene);
     /**
-     * 合成结束回调
-     * @param {(composition: Composition) => void} func
-     * @deprecated since 2.0 - use `onEnd` instead
+     * 所有合成 Item 的根变换
      */
-    set handleEnd(func: (composition: Composition) => void);
+    get transform(): import("@galacean/effects-core").Transform;
     /**
      * 获取场景中的纹理数组
      */
@@ -203,7 +196,7 @@ export declare class Composition implements Disposable, LostHandler {
     /**
      * 获取合成中所有元素
      */
-    get items(): VFXItem<VFXItemContent>[];
+    get items(): VFXItem[];
     /**
      * 获取合成开始渲染的时间
      */
@@ -216,6 +209,8 @@ export declare class Composition implements Disposable, LostHandler {
      * 获取销毁状态
      */
     get isDestroyed(): boolean;
+    set viewportMatrix(matrix: Matrix4);
+    get viewportMatrix(): Matrix4;
     /**
      * 获取合成的时长
      */
@@ -239,6 +234,12 @@ export declare class Composition implements Disposable, LostHandler {
      * @param speed - 速度
      */
     setSpeed(speed: number): void;
+    /**
+     * 设置合成的可见性
+     * @since 2.0.0
+     * @param visible - 是否可见
+     */
+    setVisible(visible: boolean): void;
     /**
      * 获取合成的动画速度
      * @returns
@@ -273,7 +274,7 @@ export declare class Composition implements Disposable, LostHandler {
      * @param time - 相对 startTime 的时间
      */
     setTime(time: number): void;
-    addItem(item: VFXItem<VFXItemContent>): void;
+    addItem(item: VFXItem): void;
     /**
      * 前进合成到指定时间
      * @param time - 相对0时刻的时间
@@ -285,22 +286,15 @@ export declare class Composition implements Disposable, LostHandler {
      */
     protected reset(): void;
     prepareRender(): void;
-    /**
-     * 是否合成需要重新播放
-     * @returns 重新播放合成标志位
-     */
-    private shouldRestart;
-    /**
-     * 是否合成需要销毁
-     * @returns 销毁合成标志位
-     */
-    private shouldDispose;
+    protected gatherRendererComponent(vfxItem: VFXItem, renderFrame: RenderFrame): void;
     /**
      * 合成更新，针对所有 item 的更新
      * @param deltaTime - 更新的时间步长
      * @param skipRender - 是否需要渲染
      */
-    update(deltaTime: number, skipRender?: boolean): void;
+    update(deltaTime: number): void;
+    private toLocalTime;
+    private shouldDispose;
     private getUpdateTime;
     private callStart;
     private callUpdate;
@@ -319,18 +313,22 @@ export declare class Composition implements Disposable, LostHandler {
      * 更新相机
      * @override
      */
-    updateCamera(): void;
+    private updateCamera;
     /**
      * 插件更新，来自 CompVFXItem 的更新调用
      * @param deltaTime - 更新的时间步长
      */
-    updatePluginLoaders(deltaTime: number): void;
+    private updatePluginLoaders;
+    /**
+     * 更新主合成组件
+     */
+    private updateRootComposition;
     /**
      * 通过名称获取元素
      * @param name - 元素名称
      * @returns 元素对象
      */
-    getItemByName(name: string): VFXItem<VFXItemContent> | undefined;
+    getItemByName(name: string): VFXItem | undefined;
     /**
      * 获取指定位置和相机连成的射线
      * @param x
@@ -356,13 +354,13 @@ export declare class Composition implements Disposable, LostHandler {
      * @param item - 交互元素
      * @param type - 交互类型
      */
-    addInteractiveItem(item: VFXItem<VFXItemContent>, type: spec.InteractType): string | undefined;
+    addInteractiveItem(item: VFXItem, type: spec.InteractType): string | undefined;
     /**
      * InteractItem 生命周期结束时的调用
      * @param item - 交互元素
      * @param type - 交互类型
      */
-    removeInteractiveItem(item: VFXItem<VFXItemContent>, type: spec.InteractType): void;
+    removeInteractiveItem(item: VFXItem, type: spec.InteractType): void;
     /**
      * 销毁插件 Item 中保存的纹理数组
      * @internal
@@ -374,7 +372,7 @@ export declare class Composition implements Disposable, LostHandler {
      * @internal
      * @param item - 需要销毁的 item
      */
-    destroyItem(item: VFXItem<VFXItemContent>): void;
+    destroyItem(item: VFXItem): void;
     lost(e: Event): void;
     /**
      * 合成对象销毁
@@ -392,6 +390,15 @@ export declare class Composition implements Disposable, LostHandler {
      * 合成整体在水平方向移动 x 像素，垂直方向移动 y 像素
      */
     translateByPixel(x: number, y: number): void;
+    /**
+     * 设置合成在画布上的像素位置
+     * Tips:
+     *  - 坐标原点在 canvas 左上角，x 正方向水平向右， y 正方向垂直向下
+     *  - 设置后会覆盖原有的位置信息
+     * @param x - x 坐标
+     * @param y - y 坐标
+     */
+    setPositionByPixel(x: number, y: number): void;
     /**
      * 设置合成在 3D 坐标轴上相对当前的位移
      */

package/dist/constants.d.ts

@@ -5,6 +5,6 @@ export declare const SEMANTIC_MAIN_PRE_COLOR_ATTACHMENT_0 = "PRE_MAIN_COLOR_0";
 export declare const SEMANTIC_MAIN_PRE_COLOR_ATTACHMENT_SIZE_0 = "PRE_MAIN_COLOR_SIZE_0";
 export declare const PLAYER_OPTIONS_ENV_EDITOR = "editor";
 export declare const HELP_LINK: {
-    'Filter not imported': string;
     'Item duration can\'t be less than 0': string;
+    'ValueType: 21/22 is not supported': string;
 };

package/dist/decorators.d.ts

@@ -1,4 +1,5 @@
+import type { Constructor } from './utils';
 export declare const effectsClassStore: Record<string, any>;
-export declare function getMergedStore(target: any): any;
-export declare function serialize(sourceName?: string): (target: any, propertyKey: any) => void;
-export declare function effectsClass(className: any): (target: any, context?: any) => void;
+export declare function effectsClass(className: string): (target: Object, context?: unknown) => void;
+export declare function serialize(type?: Constructor, sourceName?: string): (target: Object, propertyKey: string | symbol) => void;
+export declare function getMergedStore(target: Object): Record<string, any> | undefined;

package/dist/downloader.d.ts

@@ -53,6 +53,15 @@ export declare function loadWebPOptional(png: string, webp?: string): Promise<{
     image: HTMLImageElement;
     url: string;
 }>;
+/**
+ * 异步加载一个 AVIF 图片文件，如果不支持 AVIF，则加载 PNG 图片文件
+ * @param png - PNG 图片文件的 URL
+ * @param avif - AVIF 图片文件的 URL
+ */
+export declare function loadAVIFOptional(png: string, avif?: string): Promise<{
+    image: HTMLImageElement;
+    url: string;
+}>;
 /**
  * 异步加载一个图片文件
  * @param source - 图片文件的 URL、Blob 或 HTMLImageElement 对象

package/dist/effects-object.d.ts

@@ -1,11 +1,14 @@
 import type * as spec from '@galacean/effects-specification';
 import type { Engine } from './engine';
+import type { ItemEvent } from './events';
+import { EventEmitter } from './events';
 /**
  * @since 2.0.0
  * @internal
  */
-export declare abstract class EffectsObject {
+export declare abstract class EffectsObject extends EventEmitter<ItemEvent> {
     engine: Engine;
+    static is(obj: unknown): obj is EffectsObject;
     protected guid: string;
     /**
      * 存储需要序列化的数据

package/dist/effects-package.d.ts

@@ -0,0 +1,19 @@
+import * as spec from '@galacean/effects-specification';
+interface FileSummary {
+    assetType: string;
+    guid: string;
+}
+/**
+ * @since 2.0.0
+ * @internal
+ */
+export declare class EffectsPackage {
+    fileSummary: FileSummary;
+    exportObjectDatas: spec.EffectsObjectData[];
+    addData(effectsObjectData: spec.EffectsObjectData): void;
+    serializeToBinary(): Uint8Array;
+    deserializeFromBinary(buffer: Uint8Array): void;
+    private geometryDataToBinary;
+    private binaryToGeometryData;
+}
+export {};

package/dist/engine.d.ts

@@ -5,10 +5,10 @@ import type { EffectsObject } from './effects-object';
 import type { Material } from './material';
 import type { GPUCapability, Geometry, Mesh, RenderPass, Renderer, ShaderLibrary } from './render';
 import type { Scene } from './scene';
-import { Texture } from './texture';
+import type { Texture } from './texture';
 import type { Disposable } from './utils';
 /**
- * Engine 基类，负责维护所有 GPU 资源的销毁
+ * Engine 基类，负责维护所有 GPU 资源的管理及销毁
  */
 export declare class Engine implements Disposable {
     renderer: Renderer;
@@ -19,6 +19,10 @@ export declare class Engine implements Disposable {
     objectInstance: Record<string, EffectsObject>;
     assetLoader: AssetLoader;
     database?: Database;
+    /**
+     * 渲染过程中错误队列
+     */
+    renderErrors: Set<Error>;
     protected destroyed: boolean;
     protected textures: Texture[];
     protected materials: Material[];
@@ -37,7 +41,7 @@ export declare class Engine implements Disposable {
     getInstance(id: string): EffectsObject;
     removeInstance(id: string): void;
     addPackageDatas(scene: Scene): void;
-    createVFXItemsAsync(scene: Scene): Promise<void>;
+    createVFXItems(scene: Scene): Promise<void>;
     addTexture(tex: Texture): void;
     removeTexture(tex: Texture): void;
     addMaterial(mat: Material): void;
@@ -50,7 +54,6 @@ export declare class Engine implements Disposable {
     removeRenderPass(pass: RenderPass): void;
     get isDestroyed(): boolean;
     getShaderLibrary(): ShaderLibrary;
-    private createDefaultTexture;
     /**
      * 销毁所有缓存的资源
      */

package/dist/events/event-emitter.d.ts

@@ -0,0 +1,46 @@
+export type EventEmitterListener<P extends any[]> = (...callbackArgs: P) => void;
+/**
+ * 事件监听器选项
+ */
+export type EventEmitterOptions = {
+    /**
+     * 是否只监听一次
+     */
+    once?: boolean;
+};
+export declare class EventEmitter<T extends Record<string, any[]>> {
+    private listeners;
+    /**
+     * 移除事件监听器
+     * @param eventName - 事件名称
+     * @param listener - 事件监听器
+     * @returns
+     */
+    off: <E extends keyof T & string>(eventName: E, listener: EventEmitterListener<T[E]>) => void;
+    /**
+     * 监听事件
+     * @param eventName - 事件名称
+     * @param listener - 事件监听器
+     * @param options - 事件监听器选项
+     * @returns
+     */
+    on: <E extends keyof T & string>(eventName: E, listener: EventEmitterListener<T[E]>, options?: EventEmitterOptions) => () => void;
+    /**
+     * 一次性监听事件
+     * @param eventName - 事件名称
+     * @param listener - 事件监听器
+     */
+    once: <E extends keyof T & string>(eventName: E, listener: EventEmitterListener<T[E]>) => void;
+    /**
+     * 触发事件
+     * @param eventName - 事件名称
+     * @param args - 事件参数
+     */
+    emit: <E extends keyof T & string>(eventName: E, ...args: T[E]) => void;
+    /**
+     * 获取事件名称对应的所有监听器
+     * @param eventName - 事件名称
+     * @returns - 返回事件名称对应的所有监听器
+     */
+    getListeners: <E extends keyof T & string>(eventName: E) => EventEmitterListener<T[E]>[];
+}

package/dist/events/index.d.ts

@@ -0,0 +1,2 @@
+export * from './types';
+export * from './event-emitter';

package/dist/events/types.d.ts

@@ -0,0 +1,37 @@
+import type { MessageItem } from '../composition';
+import type { Region } from '../plugins';
+/**
+ * Item 可以绑定的事件
+ */
+export type ItemEvent = {
+    /**
+     * 元素点击事件
+     */
+    ['click']: [region: Region];
+    /**
+     * 元素消息事件（元素创建/销毁时触发）
+     */
+    ['message']: [message: Omit<MessageItem, 'compositionId'>];
+};
+/**
+ * Compositio 可以绑定的事件
+ */
+export type CompositionEvent<C> = {
+    /**
+     * 合成点击事件
+     */
+    ['click']: [
+        clickInfo: Region & {
+            compositionName: string;
+            compositionId: string;
+        }
+    ];
+    /**
+     * 合成结束事件
+     * 合成行为为循环时每次循环结束都会触发
+     * 合成行为为销毁/冻结时只会触发一次
+     */
+    ['end']: [endInfo: {
+        composition: C;
+    }];
+};

package/dist/fallback/camera.d.ts

@@ -0,0 +1,2 @@
+import type { CameraContent } from '@galacean/effects-specification';
+export declare function getStandardCameraContent(model: any): CameraContent;

package/dist/fallback/index.d.ts

@@ -0,0 +1,12 @@
+import type { BaseItem, Composition, CompressedImage, Image, JSONScene, ParticleItem, RenderLevel, SpriteItem, TemplateImage } from '@galacean/effects-specification';
+export * from './utils';
+export declare function getStandardJSON(json: any): JSONScene;
+export declare function getStandardImage(image: any, index: number, imageTags: RenderLevel[]): TemplateImage | Image | CompressedImage;
+export declare function getStandardComposition(composition: any, opt?: {
+    plugins?: string[];
+    requires?: string[];
+}): Composition;
+export declare function getStandardItem(item: any, opt?: {
+    plugins?: string[];
+    requires?: string[];
+}): SpriteItem | ParticleItem | BaseItem;

package/dist/fallback/interact.d.ts

@@ -0,0 +1,2 @@
+import type { InteractContent } from '@galacean/effects-specification';
+export declare function getStandardInteractContent(ui: any): InteractContent;

package/dist/fallback/migration.d.ts

@@ -0,0 +1,20 @@
+import type { BaseContent, BinaryFile, JSONScene, JSONSceneLegacy, SpineResource, SpineContent } from '@galacean/effects-specification';
+/**
+ * 2.1 以下版本数据适配（mars-player@2.4.0 及以上版本支持 2.1 以下数据的适配）
+ */
+export declare function version21Migration(json: JSONSceneLegacy): JSONSceneLegacy;
+/**
+ * 2.2 以下版本数据适配（mars-player@2.5.0 及以上版本支持 2.2 以下数据的适配）
+ */
+export declare function version22Migration(json: JSONSceneLegacy): JSONSceneLegacy;
+/**
+ * 3.0 以下版本数据适配（runtime 2.0及以上版本支持）
+ */
+export declare function version30Migration(json: JSONSceneLegacy): JSONScene;
+/**
+ * 2.5 以下版本 赫尔米特数据转换成贝塞尔数据
+ */
+export declare function version24Migration(json: JSONScene): JSONScene;
+export declare function convertParam(content?: BaseContent): void;
+export declare function convertBinaryAsset(bins: BinaryFile[], jsonScene: JSONScene): void;
+export declare function convertSpineData(resource: SpineResource, content: SpineContent, jsonScene: JSONScene): void;

package/dist/fallback/particle.d.ts

@@ -0,0 +1,2 @@
+import type { ParticleContent } from '@galacean/effects-specification';
+export declare function getStandardParticleContent(particle: any): ParticleContent;

package/dist/fallback/sprite.d.ts

@@ -0,0 +1,3 @@
+import type { BaseItemTransform, NullContent, SpriteContent } from '@galacean/effects-specification';
+export declare function getStandardNullContent(sprite: any, transform: BaseItemTransform): NullContent;
+export declare function getStandardSpriteContent(sprite: any, transform: BaseItemTransform): SpriteContent;

package/dist/fallback/utils.d.ts

@@ -0,0 +1,25 @@
+import type { FixedNumberExpression, RGBAColorValue, ColorExpression, NumberExpression, GradientColor, FixedVec3Expression, vec4, vec3, BezierKeyframeValue, vec2 } from '@galacean/effects-specification';
+import { ParticleOrigin } from '@galacean/effects-specification';
+export declare function arrAdd<T>(arr: T[], item: T): boolean | undefined;
+export declare function ensureFixedNumber(a: any): FixedNumberExpression | undefined;
+export declare function ensureFixedNumberWithRandom(a: any, p: number): FixedNumberExpression | undefined;
+export declare function ensureRGBAValue(a: any): RGBAColorValue;
+export declare function ensureColorExpression(a: any, normalized?: boolean): ColorExpression | undefined;
+export declare function ensureNumberExpression(a: any): NumberExpression | undefined;
+export declare function ensureValueGetter(a: any): any;
+export declare function ensureGradient(a: any, normalized?: boolean): GradientColor | undefined;
+export declare function colorToArr(hex: string | number[], normalized?: boolean): vec4;
+export declare function normalizeColor(a: number[]): number[] | undefined;
+export declare function parsePercent(c: string): number;
+export declare function getGradientColor(color: string | Array<string | number[]> | GradientColor, normalized?: boolean): GradientColor | undefined;
+export declare function ensureFixedVec3(a: any): FixedVec3Expression | undefined;
+export declare function objectValueToNumber(o: Record<string, any>): object;
+export declare function deleteEmptyValue(o: Record<string, any>): object;
+export declare function quatFromXYZRotation(out: vec4 | number[], x: number, y: number, z: number): vec4;
+export declare function rotationZYXFromQuat(out: vec3 | number[], quat: vec4): vec3;
+/**
+ * 提取并转换 JSON 数据中的 anchor 值
+ */
+export declare function convertAnchor(anchor?: vec2, particleOrigin?: ParticleOrigin): vec2;
+export declare const particleOriginTranslateMap: Record<number, vec2>;
+export declare function getBezierCurveFromHermiteInGE(geHermiteCurves: number[][]): BezierKeyframeValue[];

package/dist/gl/create-gl-context.d.ts

@@ -1,3 +1,4 @@
+export type GLType = 'webgl' | 'webgl2';
 /**
  * Helper class to create a WebGL Context
  *
@@ -6,4 +7,4 @@
  * @param options
  * @returns
  */
-export declare function createGLContext(canvas: HTMLCanvasElement | OffscreenCanvas, glType: "webgl" | "webgl2" | undefined, options: WebGLContextAttributes): WebGLRenderingContext | WebGL2RenderingContext;
+export declare function createGLContext(canvas: HTMLCanvasElement | OffscreenCanvas, glType: GLType | undefined, options: WebGLContextAttributes): WebGLRenderingContext | WebGL2RenderingContext;