@galacean/effects-core 2.10.0-alpha.0 → 2.10.0-alpha.1

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

@@ -12,6 +12,10 @@ import { RendererComponent } from './renderer-component';
  */
 export interface ItemRenderer extends Required<Omit<spec.RendererOptions, 'texture' | 'shape' | 'anchor' | 'particleOrigin' | 'mask'>> {
     texture: Texture;
+    /**
+     * @deprecated 2.10 起此字段无实际意义，仅为兼容老版本读取保留；
+     * 请使用 `MaskProcessor.getMaskReferences()` 获取当前蒙版引用列表
+     */
     mask: number;
 }
 interface MaskableGraphicData extends spec.ComponentData {

package/dist/composition.d.ts

@@ -396,6 +396,11 @@ export declare class Composition extends EventEmitter<CompositionEvent<Compositi
      */
     removeInteractiveItem(item: VFXItem, type: spec.InteractType): void;
     lost(e: Event): void;
+    /**
+     * 上下文恢复后的空操作。
+     * GPU 资源已由引擎统一重建，视频纹理会在下次渲染时自然更新，不自动重新播放。
+     */
+    restore(): void;
     /**
      * 合成对象销毁
      */

package/dist/engine.d.ts

@@ -4,6 +4,7 @@ import type { Database, SceneData } from './asset-loader';
 import type { EffectsObject } from './effects-object';
 import type { Material } from './material';
 import type { GPUCapability, Geometry, Mesh, RenderPass, RenderPassClearAction, Renderer, RenderingData, ShaderLibrary } from './render';
+import type { Framebuffer, Renderbuffer } from './render';
 import { Graphics, RenderTargetPool } from './render';
 import type { Scene, SceneRenderLevel } from './scene';
 import type { Texture } from './texture';
@@ -25,6 +26,14 @@ export interface EngineOptions extends WebGLContextAttributes {
     pixelRatio?: number;
     notifyTouch?: boolean;
     interactive?: boolean;
+    /**
+     * 是否不处理 WebGL 上下文丢失恢复。
+     * - `true`（默认）：上传 GPU 后释放 CPU 端源数据以节省内存；上下文丢失后不自动恢复，
+     *   渲染暂停，等待宿主重建资源后手动恢复播放。
+     * - `false`：保留 CPU 端源数据，上下文丢失后引擎自动按资源类型就地重建 GPU 资源并恢复渲染。
+     *   该配置为构造期选项，运行时从 `true` 改为 `false` 无法找回已经丢弃的源数据。
+     */
+    doNotHandleContextLost?: boolean;
 }
 type EngineEvent = {
     contextlost: [eventData: {
@@ -95,12 +104,22 @@ export declare class Engine extends EventEmitter<EngineEvent> implements Disposa
      */
     renderingData: RenderingData;
     graphics: Graphics;
+    /**
+     * 是否不处理上下文丢失恢复（构造期配置，默认 true）
+     */
+    doNotHandleContextLost: boolean;
+    /**
+     * WebGL 上下文是否处于丢失状态
+     */
+    protected contextWasLost: boolean;
     protected _disposed: boolean;
     protected textures: Texture[];
     protected materials: Material[];
     protected geometries: Geometry[];
     protected meshes: Mesh[];
     protected renderPasses: RenderPass[];
+    protected framebuffers: Framebuffer[];
+    protected renderbuffers: Renderbuffer[];
     private assetLoader;
     private clearAction;
     get disposed(): boolean;
@@ -140,6 +159,10 @@ export declare class Engine extends EventEmitter<EngineEvent> implements Disposa
     removeMesh(mesh: Mesh): void;
     addRenderPass(pass: RenderPass): void;
     removeRenderPass(pass: RenderPass): void;
+    addFramebuffer(framebuffer: Framebuffer): void;
+    removeFramebuffer(framebuffer: Framebuffer): void;
+    addRenderbuffer(renderbuffer: Renderbuffer): void;
+    removeRenderbuffer(renderbuffer: Renderbuffer): void;
     addComposition(composition: Composition): void;
     removeComposition(composition: Composition): void;
     getWidth(): number;

package/dist/fallback/migration.d.ts

@@ -26,6 +26,19 @@ export declare function version33Migration(json: JSONScene): JSONScene;
 export declare function version34Migration(json: JSONScene): JSONScene;
 export declare function version35Migration(json: JSONScene): JSONScene;
 export declare function version36Migration(json: JSONScene): JSONScene;
+/**
+ * 3.8 数据适配：SpriteComponent 的 renderer.texture + splits 迁移为独立 Sprite 资产。
+ *
+ * - 遍历所有未引用 sprite 的 SpriteComponentData，按 splits[0]（无则整图 [0,0,1,1]）生成
+ *   Sprite 资产对象放入 miscs，并把组件的 sprite 指向它。
+ * - 删除组件的 splits 与 renderer.texture（纹理归属 sprite，renderer 仅保留渲染状态）。
+ * - 卫语句 `if (sc.sprite) continue` 处理混合数据（部分组件已用 sprite）。
+ * - 多 split（splits.length>1，2x2 纹理打包）保留原 splits 不迁移，仍走 updateGeometryFromMultiSplit 旧路径。
+ *
+ * 由 getStandardJSON 以 `minorVersion < 8` 守卫调用，数据生命周期内只跑一次。
+ * version 字段设为字符串 '3.8'（JSONSceneVersion 枚举无此值，运行时不依赖枚举）。
+ */
+export declare function version37Migration(json: spec.JSONScene): spec.JSONScene;
 export declare function processContent(composition: spec.CompositionData): void;
 export declare function processMask(renderContent: any): void;
 export declare function convertParam(content?: BaseContent): void;