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

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/components/frame-component.d.ts

@@ -18,6 +18,16 @@ export declare class FrameComponent extends RendererComponent implements Maskabl
     drawStencilMask(maskRef: number): void;
     fromData(data: FrameComponentData): void;
     private getHitTestParams;
+    /**
+     * 由相机把命中带的屏幕像素厚度换算成世界厚度。对齐 Excalidraw frame 命中阈值：
+     * 描边两侧各 0.85 × DEFAULT_COLLISION_THRESHOLD（≈8px），整条带 ≈13.6px，不受 size/scale/zoom 影响。
+     */
+    private getBorderWorldThickness;
+    /**
+     * 构造以 frame 边为中心、给定世界厚度的边框环带三角形（内部镂空）。
+     * 带中心落在 frame 边上：half 向外、half 向内；沿 frame 局部坐标轴偏移以兼容旋转。
+     */
+    private getBorderTriangles;
     private setClipRectangle;
     private setClipRectangleRecursive;
 }

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

@@ -2,7 +2,7 @@ import type * as spec from '@galacean/effects-specification';
 import type { Engine } from '../engine';
 import type { Maskable } from '../material';
 import type { BoundingBoxTriangle, HitTestTriangleParams, BoundingBoxInfo } from '../plugins';
-import type { Geometry, Renderer } from '../render';
+import { type Geometry, type Renderer } from '../render';
 import { RendererComponent } from './renderer-component';
 interface MeshComponentData extends spec.ComponentData {
     mask?: spec.MaskOptions;

package/dist/composition.d.ts

@@ -88,18 +88,14 @@ export interface CompositionProps {
     baseRenderOrder?: number;
     /**
      *
-     * @param message
-     * @returns
      */
-    onItemMessage?: (message: MessageItem) => void;
-    /**
-     *
-     */
-    event?: EventSystem;
+    speed?: number;
     /**
      *
+     * @param message
+     * @returns
      */
-    speed?: number;
+    onItemMessage?: (message: MessageItem) => void;
 }
 /**
  * 合成抽象类：核心对象，通常一个场景只包含一个合成，可能会有多个合成。
@@ -396,6 +392,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

@@ -3,7 +3,8 @@ import type { Matrix4 } from '@galacean/effects-math/es/core/matrix4';
 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 { DataArray, DataBuffer, DataBufferOptions, GPUCapability, Geometry, IndicesArray, Mesh, RenderPass, RenderPassClearAction, Renderer, RenderingData, ShaderLibrary, ShaderVariant, VertexBuffer } from './render';
+import type { Framebuffer, Renderbuffer } from './render';
 import { Graphics, RenderTargetPool } from './render';
 import type { Scene, SceneRenderLevel } from './scene';
 import type { Texture } from './texture';
@@ -14,6 +15,7 @@ import { AssetService } from './asset-service';
 import { Ticker } from './ticker';
 import type { PointerEventData, Region } from './plugins';
 import { EventSystem } from './plugins';
+import type { ParticleSystem } from './plugins/particle/particle-system';
 import type { GLType } from './gl';
 import { EventEmitter } from './events';
 export interface EngineOptions extends WebGLContextAttributes {
@@ -25,6 +27,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: {
@@ -43,6 +53,10 @@ type EngineEvent = {
  * Engine 基类，负责维护所有 GPU 资源的管理及销毁
  */
 export declare class Engine extends EventEmitter<EngineEvent> implements Disposable {
+    /**
+     * 创建 Engine 对象。
+     */
+    static create: (canvas: HTMLCanvasElement, options?: EngineOptions) => Engine;
     name: string;
     speed: number;
     displayAspect: number;
@@ -94,24 +108,32 @@ 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[];
+    protected particleSystems: ParticleSystem[];
+    private _graphics;
     private assetLoader;
     private clearAction;
-    get disposed(): boolean;
     /**
      *
      */
     constructor(canvas: HTMLCanvasElement, options?: EngineOptions);
-    /**
-     * 创建 Engine 对象。
-     */
-    static create: (canvas: HTMLCanvasElement, options?: EngineOptions) => Engine;
+    get graphics(): Graphics;
+    get disposed(): boolean;
     clearResources(): void;
     addEffectsObjectData(data: spec.EffectsObjectData): void;
     findEffectsObjectData(uuid: string): spec.EffectsObjectData;
@@ -129,7 +151,15 @@ export declare class Engine extends EventEmitter<EngineEvent> implements Disposa
      */
     resize(): void;
     setSize(width: number, height: number): void;
-    private getTargetSize;
+    createVertexBuffer(data: DataArray | number, options: DataBufferOptions): DataBuffer;
+    createDynamicVertexBuffer(data: DataArray | number, options: DataBufferOptions): DataBuffer;
+    createIndexBuffer(indices: IndicesArray, options: DataBufferOptions): DataBuffer;
+    updateDynamicVertexBuffer(vertexBuffer: DataBuffer, data: DataArray, byteOffset?: number, byteLength?: number): void;
+    updateDynamicIndexBuffer(indexBuffer: DataBuffer, indices: IndicesArray, byteOffset?: number): void;
+    /** @hide */
+    releaseBuffer(buffer: DataBuffer): boolean;
+    /** @hide */
+    bindBuffers(vertexBuffers: Record<string, VertexBuffer>, indexBuffer: DataBuffer | undefined, effect: ShaderVariant): void;
     addTexture(tex: Texture): void;
     removeTexture(tex: Texture): void;
     addMaterial(mat: Material): void;
@@ -140,6 +170,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;
@@ -182,5 +216,6 @@ export declare class Engine extends EventEmitter<EngineEvent> implements Disposa
      * 销毁所有缓存的资源
      */
     dispose(): void;
+    private getTargetSize;
 }
 export {};

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;