@galacean/effects-core 2.4.0-beta.0 → 2.4.0-beta.2

package/dist/material/mask-ref-manager.d.ts

@@ -1,6 +1,7 @@
 import type { Engine } from '../engine';
-import type { MaskProps } from './types';
+import type { MaskProps, Maskable } from './types';
 import { MaskMode } from './types';
+import type { Renderer } from '../render/renderer';
 export declare class MaskRefManager {
     currentRef: number;
     constructor(initRef?: number);
@@ -9,7 +10,9 @@ export declare class MaskRefManager {
 export declare class MaskProcessor {
     engine: Engine;
     maskRef: number;
+    maskable?: Maskable;
     constructor(engine: Engine);
     getRefValue(): number;
     getMaskMode(data: MaskProps): MaskMode;
+    drawStencilMask(renderer: Renderer): void;
 }

package/dist/material/material.d.ts

@@ -177,7 +177,12 @@ export declare abstract class Material extends EffectsObject implements Disposab
      * 设置 Material 颜色缓冲区的写入开关
      * @param value
      */
-    set colorMask(value: UndefinedAble<[r: boolean, g: boolean, b: boolean, a: boolean]>);
+    abstract set colorMask(value: boolean);
+    /**
+     * 获取 Material 颜色缓冲区的写入开关
+     * @param value
+     */
+    abstract get colorMask(): boolean;
     /**
      * 分别指定 Material 的模板测试掩码
      * @param value - 模板测试写入掩码参数

package/dist/material/types.d.ts

@@ -3,6 +3,7 @@ import type { Matrix3, Matrix4, Vector2, Vector3, Vector4 } from '@galacean/effe
 import type { Texture } from '../texture';
 import type { DestroyOptions } from '../utils';
 import type { MaskProcessor } from './mask-ref-manager';
+import type { Renderer } from '../render';
 export type UniformSemantic = 'VIEW' | 'MODEL' | 'MODELVIEW' | 'PROJECTION' | 'VIEWPROJECTION' | 'VIEWINVERSE' | 'EDITOR_TRANSFORM' | 'MODELVIEWPROJECTION';
 export interface MaterialBlendingStates {
     blending?: boolean;
@@ -72,6 +73,7 @@ export interface MaskProps {
  */
 export interface Maskable {
     readonly maskManager: MaskProcessor;
+    drawStencilMask: (renderer: Renderer) => void;
 }
 export declare enum MaskMode {
     /**

package/dist/plugins/camera/camera-controller-node.d.ts

@@ -1,7 +1,7 @@
 import * as spec from '@galacean/effects-specification';
-import { Behaviour } from '../../components';
+import { Component } from '../../components';
 import type { Engine } from '../../engine';
-export declare class CameraController extends Behaviour {
+export declare class CameraController extends Component {
     private options;
     constructor(engine: Engine, props?: spec.CameraContent);
     onUpdate(): void;

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

@@ -33,6 +33,7 @@ export declare class InteractComponent extends RendererComponent {
     private duringPlay;
     /** 是否响应点击和拖拽交互事件 */
     private _interactive;
+    private lastTime;
     set interactive(enable: boolean);
     get interactive(): boolean;
     getDragRangeX(): [min: number, max: number];

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

@@ -7,12 +7,14 @@ import { ParticleMesh } from './particle-mesh';
 import type { Mesh, Renderer } from '../../render';
 import type { Engine } from '../../engine';
 import { RendererComponent } from '../../components';
+import type { MaskProcessor } from '../../material/mask-ref-manager';
 /**
  * @since 2.0.0
  */
 export declare class ParticleSystemRenderer extends RendererComponent {
     meshes: Mesh[];
     particleMesh: ParticleMesh;
+    maskManager: MaskProcessor;
     private trailMesh?;
     constructor(engine: Engine, particleMeshProps?: ParticleMeshProps, trailMeshProps?: TrailMeshProps);
     onStart(): void;

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

@@ -139,7 +139,7 @@ export interface ParticleTrailProps extends Omit<spec.ParticleTrail, 'texture' |
     };
 }
 export type ParticleContent = [number, number, number, Point];
-export declare class ParticleSystem extends Component implements Maskable {
+export declare class ParticleSystem extends Component {
     renderer: ParticleSystemRenderer;
     options: ParticleOptions;
     shape: ShapeGenerator;

package/dist/plugins/particle/trail-mesh.d.ts

@@ -11,7 +11,7 @@ export type TrailMeshProps = {
     maxTrailCount: number;
     pointCountPerTrail: number;
     colorOverLifetime?: Array<GradientStop>;
-    texture: Texture;
+    texture?: Texture;
     minimumVertexDistance: number;
     blending: number;
     widthOverTrail: ValueGetter<number>;

package/dist/serialization-helper.d.ts

@@ -1,17 +1,13 @@
 import type * as spec from '@galacean/effects-specification';
 import { EffectsObject } from './effects-object';
 export declare class SerializationHelper {
-    static collectSerializableObject(effectsObject: EffectsObject, res: Record<string, EffectsObject>): void;
-    static serializeEffectObject(effectsObject: EffectsObject): Record<string, any>;
     static serialize(effectsObject: EffectsObject, serializedData?: Record<string, any>): Record<string, any>;
     static deserialize(serializedData: spec.EffectsObjectData, effectsObject: EffectsObject): void;
-    static deserializeAsync(serializedData: spec.EffectsObjectData, effectsObject: EffectsObject): Promise<void>;
     static checkTypedArray(obj: unknown): boolean;
     static checkDataPath(value: unknown): value is spec.DataPath;
     static checkGLTFNode(value: any): boolean;
     static checkImageSource(value: HTMLCanvasElement): boolean;
     private static deserializeProperty;
-    private static deserializePropertyAsync;
     private static serializeObjectProperty;
     private static serializeArrayProperty;
 }

package/dist/vfx-item.d.ts

@@ -1,8 +1,7 @@
 import { Vector3 } from '@galacean/effects-math/es/core/vector3';
 import * as spec from '@galacean/effects-specification';
 import type { Component } from './components';
-import { RendererComponent } from './components';
-import { type Composition } from './composition';
+import { Composition } from './composition';
 import { EffectsObject } from './effects-object';
 import type { Engine } from './engine';
 import type { EventEmitterListener, EventEmitterOptions, ItemEvent } from './events';
@@ -61,9 +60,8 @@ export declare class VFXItem extends EffectsObject implements Disposable {
     _content?: VFXItemContent;
     type: spec.ItemType;
     props: spec.VFXItemData;
-    isDuringPlay: boolean;
     components: Component[];
-    rendererComponents: RendererComponent[];
+    isDuringPlay: boolean;
     /**
      * 元素是否激活
      */
@@ -295,6 +293,12 @@ export declare class VFXItem extends EffectsObject implements Disposable {
      */
     getCurrentPosition(): Vector3;
     find(name: string): VFXItem | undefined;
+    /**
+     * 复制 VFXItem，返回一个新的 VFXItem
+     * @since 2.4.0
+     * @returns 复制的新 VFXItem
+     */
+    duplicate(): VFXItem;
     fromData(data: spec.VFXItemData): void;
     toData(): void;
     translateByPixel(x: number, y: number): void;
@@ -304,6 +308,8 @@ export declare class VFXItem extends EffectsObject implements Disposable {
     dispose(): void;
     private resetChildrenParent;
     private instantiatePreComposition;
+    private resetGUID;
+    private gatherPreviousObjectID;
 }
 export declare namespace Item {
     function is<T extends spec.Item>(item: spec.Item, type: spec.ItemType): item is T;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@galacean/effects-core",
-  "version": "2.4.0-beta.0",
+  "version": "2.4.0-beta.2",
   "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.3.0",
+    "@galacean/effects-specification": "2.3.1",
     "@galacean/effects-math": "1.1.0",
     "flatbuffers": "24.3.25",
     "uuid": "9.0.1",