@galacean/effects-core 2.0.0-alpha.2 → 2.0.0-alpha.20

package/dist/engine.d.ts

@@ -1,13 +1,14 @@
-import type { Database, EffectsObjectData, SceneData } from './asset-loader';
+import * as spec from '@galacean/effects-specification';
+import type { Database, SceneData } from './asset-loader';
 import { AssetLoader } from './asset-loader';
 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;
@@ -18,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[];
@@ -30,13 +35,13 @@ export declare class Engine implements Disposable {
      */
     static create: (gl: WebGLRenderingContext | WebGL2RenderingContext) => Engine;
     clearResources(): void;
-    addEffectsObjectData(data: EffectsObjectData): void;
-    findEffectsObjectData(uuid: string): EffectsObjectData;
+    addEffectsObjectData(data: spec.EffectsObjectData): void;
+    findEffectsObjectData(uuid: string): spec.EffectsObjectData;
     addInstance(effectsObject: EffectsObject): void;
     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;
@@ -49,7 +54,6 @@ export declare class Engine implements Disposable {
     removeRenderPass(pass: RenderPass): void;
     get isDestroyed(): boolean;
     getShaderLibrary(): ShaderLibrary;
-    private createDefaultTexture;
     /**
      * 销毁所有缓存的资源
      */

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;

package/dist/gl/index.d.ts

@@ -1,6 +1,9 @@
+import * as spec from '@galacean/effects-specification';
 export * from './create-gl-context';
 export * from './gpu-time';
 export declare const initErrors: string[];
 export declare const glContext: WebGL2RenderingContext;
 export declare function initGLContext(): void;
 export declare function isWebGL2(gl: WebGLRenderingContext | WebGL2RenderingContext): gl is WebGL2RenderingContext;
+export declare function vertexFormatType2GLType(formatType: spec.VertexFormatType): spec.BufferType;
+export declare function glType2VertexFormatType(webglType: spec.BufferType): spec.VertexFormatType;

package/dist/image-asset.d.ts

@@ -0,0 +1,5 @@
+import { EffectsObject } from './effects-object';
+import type { ImageSource } from './scene';
+export declare class ImageAsset extends EffectsObject {
+    data: ImageSource;
+}

package/dist/index.d.ts

@@ -1,8 +1,9 @@
 export * as math from '@galacean/effects-math/es/core/index';
 export * as spec from '@galacean/effects-specification';
-export { getStandardComposition, getStandardImage, getStandardItem, getStandardJSON, } from '@galacean/effects-specification/dist/fallback';
+export * from './asset-loader';
 export * from './asset-manager';
 export * from './camera';
+export * from './canvas-pool';
 export * from './comp-vfx-item';
 export * from './components';
 export * from './composition';
@@ -10,10 +11,10 @@ export * from './composition-source-manager';
 export * from './config';
 export * from './constants';
 export * from './decorators';
-export * from './asset-loader';
 export * from './downloader';
 export * from './effects-object';
 export * from './engine';
+export { ensureFixedNumber, getStandardComposition, getStandardImage, getStandardItem, getStandardJSON, normalizeColor } from './fallback';
 export * from './gl';
 export * from './material';
 export * from './math';
@@ -22,13 +23,15 @@ export * from './plugin-system';
 export * from './plugins';
 export * from './render';
 export * from './scene';
-export * from './semantic-map';
+export * from './serialization-helper';
 export * from './shader';
 export * from './shape';
 export * from './template-image';
 export * from './texture';
-export * from './serialization-helper';
 export * from './ticker';
 export * from './transform';
 export * from './utils';
 export * from './vfx-item';
+export * from './binary-asset';
+export * from './effects-object';
+export declare const version: string;