@galacean/effects-core 2.8.0-alpha.2 → 2.8.0-alpha.4

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,18 @@ 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;
+    /**
+     * 设置文本框高度
+     * @param value - 文本框高度
+     */
+    setTextHeight(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/render/post-process-pass.d.ts

@@ -1,37 +1,22 @@
 import type { RenderPassDestroyOptions } from './render-pass';
 import { RenderTargetHandle, RenderPass } from './render-pass';
 import type { Renderer } from './renderer';
-export declare class BloomThresholdPass extends RenderPass {
+export declare class BloomPass extends RenderPass {
     sceneTextureHandle: RenderTargetHandle;
+    private readonly iterationCount;
+    private thresholdMaterial;
+    private downSampleHMaterial;
+    private downSampleVMaterial;
+    private upSampleMaterial;
+    private tempRTs;
+    private thresholdRT;
     private mainTexture;
-    private screenMesh;
-    constructor(renderer: Renderer);
+    constructor(renderer: Renderer, iterationCount?: number);
     configure(renderer: Renderer): void;
     execute(renderer: Renderer): void;
     onCameraCleanup(renderer: Renderer): void;
     dispose(options?: RenderPassDestroyOptions): void;
 }
-export declare class HQGaussianDownSamplePass extends RenderPass {
-    gaussianResult: RenderTargetHandle;
-    private mainTexture;
-    private screenMesh;
-    private readonly type;
-    private readonly level;
-    constructor(renderer: Renderer, type: 'V' | 'H', level: number);
-    configure(renderer: Renderer): void;
-    execute(renderer: Renderer): void;
-    onCameraCleanup(renderer: Renderer): void;
-}
-export declare class HQGaussianUpSamplePass extends RenderPass {
-    gaussianDownSampleResult: RenderTargetHandle;
-    private mainTexture;
-    private screenMesh;
-    private readonly level;
-    constructor(renderer: Renderer, level: number);
-    configure(renderer: Renderer): void;
-    execute(renderer: Renderer): void;
-    onCameraCleanup(renderer: Renderer): void;
-}
 export declare class ToneMappingPass extends RenderPass {
     private screenMesh;
     private sceneTextureHandle;

package/dist/render/renderer.d.ts

@@ -9,6 +9,7 @@ import type { RenderFrame, RenderingData } from './render-frame';
 import type { RenderPassClearAction } from './render-pass';
 import type { ShaderLibrary } from './shader';
 import { RenderTargetPool } from './render-target-pool';
+import type { Texture } from '../texture';
 export declare class Renderer implements LostHandler, RestoreHandler {
     engine: Engine;
     static create: (engine: Engine) => Renderer;
@@ -51,5 +52,12 @@ export declare class Renderer implements LostHandler, RestoreHandler {
     drawGeometry(geometry: Geometry, matrix: Matrix4, material: Material, subMeshIndex?: number): void;
     getTemporaryRT(name: string, width: number, height: number, depthBuffer: number, filter: FilterMode, format: RenderTextureFormat): Framebuffer;
     releaseTemporaryRT(rt: Framebuffer): void;
+    /**
+     * 将源纹理复制到目标 Framebuffer，可使用自定义材质进行处理
+     * @param source - 源纹理
+     * @param destination - 目标 Framebuffer，如果为 null 则渲染到屏幕
+     * @param material - 可选的自定义材质，不传则使用默认复制材质
+     */
+    blit(source: Texture, destination: Framebuffer | null, material?: Material): void;
     dispose(): void;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@galacean/effects-core",
-  "version": "2.8.0-alpha.2",
+  "version": "2.8.0-alpha.4",
   "description": "Galacean Effects runtime core for the web",
   "module": "./dist/index.mjs",
   "main": "./dist/index.js",