@galacean/effects-core 2.8.0-alpha.3 → 2.8.0-alpha.5

package/dist/plugin-system.d.ts

@@ -1,5 +1,5 @@
 import type { Composition } from './composition';
-import type { AbstractPlugin, PluginConstructor } from './plugins';
+import type { Plugin, PluginConstructor } from './plugins';
 import type { Scene, SceneLoadOptions } from './scene';
 import type { Engine } from './engine';
 export declare const pluginLoaderMap: Record<string, PluginConstructor>;
@@ -16,10 +16,10 @@ export declare function registerPlugin(name: string, pluginClass: PluginConstruc
  */
 export declare function unregisterPlugin(name: string): void;
 export declare class PluginSystem {
-    static getPlugins(): AbstractPlugin[];
+    static getPlugins(): Plugin[];
     static initializeComposition(composition: Composition, scene: Scene): void;
     static destroyComposition(comp: Composition): void;
-    static processAssets(scene: Scene, options?: SceneLoadOptions): Promise<void[]>;
-    static loadResources(scene: Scene, options: SceneLoadOptions, engine: Engine): void;
+    static onAssetsLoadStart(scene: Scene, options?: SceneLoadOptions): Promise<void[]>;
+    static onAssetsLoadFinish(scene: Scene, options: SceneLoadOptions, engine: Engine): void;
 }
 export declare function getPluginUsageInfo(name: string): string;

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

@@ -1,3 +1,3 @@
-import { AbstractPlugin } from '../plugin';
-export declare class CalculateLoader extends AbstractPlugin {
+import { Plugin } from '../plugin';
+export declare class CalculateLoader extends Plugin {
 }

package/dist/plugins/camera/camera-vfx-item-loader.d.ts

@@ -1,3 +1,3 @@
-import { AbstractPlugin } from '../plugin';
-export declare class CameraVFXItemLoader extends AbstractPlugin {
+import { Plugin } from '../plugin';
+export declare class CameraVFXItemLoader extends Plugin {
 }

package/dist/plugins/interact/interact-loader.d.ts

@@ -1,3 +1,3 @@
-import { AbstractPlugin } from '../plugin';
-export declare class InteractLoader extends AbstractPlugin {
+import { Plugin } from '../plugin';
+export declare class InteractLoader extends Plugin {
 }

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

@@ -1,5 +1,5 @@
 import type { Engine } from '../../engine';
-import { AbstractPlugin } from '../plugin';
-export declare class ParticleLoader extends AbstractPlugin {
+import { Plugin } from '../plugin';
+export declare class ParticleLoader extends Plugin {
     engine: Engine;
 }

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

@@ -183,7 +183,8 @@ export declare class ParticleSystem extends Component implements Maskable {
     reset(): void;
     onStart(): void;
     onUpdate(dt: number): void;
-    update(delta: number): void;
+    simulate(time: number): void;
+    private update;
     drawStencilMask(renderer: Renderer): void;
     onDestroy(): void;
     getParticleBoxes(): {

package/dist/plugins/plugin.d.ts

@@ -2,35 +2,40 @@ import type { Scene, SceneLoadOptions } from '../scene';
 import type { Composition } from '../composition';
 import type { Engine } from '../engine';
 export interface PluginConstructor {
-    new (): AbstractPlugin;
+    new (): Plugin;
     [key: string]: any;
 }
 /**
  * 抽象插件类
  * 注册合成不同生命周期的回调函数
  */
-export declare abstract class AbstractPlugin {
+export declare abstract class Plugin {
     order: number;
     name: string;
-    initialize(): void;
     /**
-     * loadScene 函数调用的时候会触发此函数，
-     * 此阶段可以加载插件所需类型资源，并返回原始资源和加载后的资源。
-     * @param scene
-     * @param options
-     * @returns
+     * 场景加载时触发，用于加载插件所需的自定义资源。
+     * 此阶段适合发起异步资源请求。
+     * @param scene - 场景对象
+     * @param options - 场景加载选项
      */
-    processAssets(scene: Scene, options?: SceneLoadOptions): Promise<void>;
+    onAssetsLoadStart(scene: Scene, options?: SceneLoadOptions): Promise<void>;
     /**
-     * loadScene 函数调用的时候会触发此函数，
-     * 此阶段时，json 中的图片和二进制已经被加载完成，可以对加载好的资源做进一步处理，
-     * 如果 promise 被 reject, loadScene 函数同样会被 reject，表示场景加载失败。
-     * 请记住，整个 load 阶段都不要创建 GL 相关的对象，只创建 JS 对象
-     * 此阶段晚于 processAssets
-     * @param {Scene} scene
-     * @param {SceneLoadOptions} options
+     * 场景资源加载完成后触发。
+     * 此时 JSON 中的图片和二进制已加载完成，可对资源做进一步处理。
+     * @param scene - 场景对象
+     * @param options - 场景加载选项
+     * @param engine - 引擎实例
      */
-    prepareResource(scene: Scene, options: SceneLoadOptions, engine: Engine): void;
-    onCompositionConstructed(composition: Composition, scene: Scene): void;
-    onCompositionDestroyed(composition: Composition): void;
+    onAssetsLoadFinish(scene: Scene, options: SceneLoadOptions, engine: Engine): void;
+    /**
+     * 合成创建完成后触发。
+     * @param composition - 合成对象
+     * @param scene - 场景对象
+     */
+    onCompositionCreated(composition: Composition, scene: Scene): void;
+    /**
+     * 合成销毁时触发。
+     * @param composition - 合成对象
+     */
+    onCompositionDestroy(composition: Composition): void;
 }

package/dist/plugins/sprite/sprite-item.d.ts

@@ -41,7 +41,6 @@ export declare class ComponentTimePlayable extends Playable {
 export declare class SpriteComponent extends MaskableGraphic {
     time: number;
     duration: number;
-    loop: boolean;
     protected textureSheetAnimation?: spec.TextureSheetAnimation;
     constructor(engine: Engine, props?: spec.SpriteComponentData);
     onUpdate(dt: number): void;

package/dist/plugins/sprite/sprite-loader.d.ts

@@ -1,4 +1,4 @@
-import { AbstractPlugin } from '../plugin';
-export declare class SpriteLoader extends AbstractPlugin {
+import { Plugin } from '../plugin';
+export declare class SpriteLoader extends Plugin {
     name: string;
 }

package/dist/plugins/text/text-item.d.ts

@@ -26,6 +26,14 @@ export declare class TextComponent extends MaskableGraphic implements ITextCompo
      * 每一行文本的最大宽度
      */
     protected maxLineWidth: number;
+    /**
+     * 初始文本宽度，用于计算缩放比例
+     */
+    private baseTextWidth;
+    /**
+     * 初始 `transform.size.x`，用于按比例更新显示宽度
+     */
+    private baseScaleX;
     private getDefaultProps;
     constructor(engine: Engine);
     onUpdate(dt: number): void;
@@ -36,7 +44,7 @@ export declare class TextComponent extends MaskableGraphic implements ITextCompo
     /**
      * 根据配置更新文本样式和布局
      */
-    protected updateWithOptions(options: spec.TextContentOptions): void;
+    updateWithOptions(options: spec.TextContentOptions): void;
     getLineCount(text: string): number;
     /**
      * 设置行高
@@ -88,6 +96,13 @@ export declare class TextComponent extends MaskableGraphic implements ITextCompo
     protected updateTexture(flipY?: boolean): void;
     renderText(options: spec.TextContentOptions): void;
     setAutoWidth(value: boolean): void;
+    /**
+     * 设置文本框宽度
+     * 手动设置宽度时会自动关闭 `autoWidth`
+     * 同时会按比例更新 `transform.size.x`，让 UI 框宽度也跟着变化
+     * @param value - 文本框宽度
+     */
+    setTextWidth(value: number): void;
     setFontSize(value: number): void;
     setOutlineWidth(value: number): void;
     setShadowBlur(value: number): void;

package/dist/plugins/text/text-loader.d.ts

@@ -1,3 +1,3 @@
-import { AbstractPlugin } from '../index';
-export declare class TextLoader extends AbstractPlugin {
+import { Plugin } from '../index';
+export declare class TextLoader extends Plugin {
 }

package/dist/scene.d.ts

@@ -72,6 +72,11 @@ export interface SceneLoadOptions {
      * @default undefined
      */
     useCompressedTexture?: boolean;
+    /**
+     * 是否使用 Hevc 视频
+     * @default undefined
+     */
+    useHevcVideo?: boolean;
     /**
      * 渲染分级。
      * 分级之后，只会加载当前渲染等级的资源。

package/dist/utils/hevc-video.d.ts

@@ -0,0 +1,13 @@
+import * as spec from '@galacean/effects-specification';
+/**
+ * Check if the browser can play the given HEVC codec.
+ * @param codec - The HEVC codec to check.
+ * @returns True if the browser can probably or maybe play the codec, false otherwise.
+ */
+export declare function canPlayHevcCodec(codec: spec.HevcVideoCodec): boolean;
+/**
+ * Parse the given codec string into a HEVC video codec enum value.
+ * @param codec - The codec string to parse.
+ * @returns The corresponding HEVC video codec enum value, or undefined if the codec is invalid.
+ */
+export declare function parseCodec(codec: string): spec.HevcVideoCodec | undefined;

package/dist/utils/index.d.ts

@@ -5,6 +5,7 @@ export * from './image-data';
 export * from './sortable';
 export * from './asserts';
 export * from './text';
+export * from './hevc-video';
 export * from './promise-util';
 export * from './logger';
 export type Immutable<O> = O extends Record<any, any> ? {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@galacean/effects-core",
-  "version": "2.8.0-alpha.3",
+  "version": "2.8.0-alpha.5",
   "description": "Galacean Effects runtime core for the web",
   "module": "./dist/index.mjs",
   "main": "./dist/index.js",
@@ -42,7 +42,7 @@
     "registry": "https://registry.npmjs.org"
   },
   "dependencies": {
-    "@galacean/effects-specification": "2.7.0-alpha.0",
+    "@galacean/effects-specification": "2.7.0",
     "@galacean/effects-math": "1.1.0",
     "flatbuffers": "24.3.25",
     "uuid": "9.0.1",