@galacean/effects-core 2.8.9 → 2.9.0-alpha.1

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

@@ -3,15 +3,15 @@ import { MaskableGraphic } from '../../components';
 import type { Engine } from '../../engine';
 import { TextLayout } from './text-layout';
 import { TextStyle } from './text-style';
-import type { ITextComponent } from './text-component-base';
 import { TextComponentBase } from './text-component-base';
+import type { Renderer } from '../../render/renderer';
 export declare const DEFAULT_FONTS: string[];
 export interface TextComponent extends TextComponentBase {
 }
 /**
  * @since 2.0.0
  */
-export declare class TextComponent extends MaskableGraphic implements ITextComponent {
+export declare class TextComponent extends MaskableGraphic {
     isDirty: boolean;
     /**
      * 文本行数
@@ -31,25 +31,21 @@ 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;
+    render(renderer: Renderer): void;
     onDestroy(): void;
     fromData(data: spec.TextComponentData): void;
     private resetState;
-    setText(value: string): void;
     /**
      * 根据配置更新文本样式和布局
      */
     updateWithOptions(options: spec.TextContentOptions): void;
+    /**
+     * 获取文本行数
+     * @param text - 文本内容
+     * @returns 行数
+     */
     getLineCount(text: string): number;
     /**
      * 设置行高
@@ -57,46 +53,8 @@ export declare class TextComponent extends MaskableGraphic implements ITextCompo
      * @param value - 行高像素值
      */
     setLineHeight(value: number): void;
-    /**
-     * 设置字重
-     * @param value - 字重类型
-     * @returns
-     */
-    setFontWeight(value: spec.TextWeight): void;
-    /**
-     * 设置字体样式
-     * @param value 设置字体样式
-     * @default "normal"
-     * @returns
-     */
-    setFontStyle(value: spec.FontStyle): void;
-    /**
-     * 设置文本水平布局
-     * @param value - 布局选项
-     * @returns
-     */
-    setTextAlign(value: spec.TextAlignment): void;
-    /**
-     * 设置文本颜色
-     * @param value - 颜色内容
-     * @returns
-     */
-    setTextColor(value: spec.RGBAColorValue): void;
-    /**
-     * 设置外描边文本颜色
-     * @param value - 颜色内容
-     * @returns
-     */
-    setOutlineColor(value: spec.RGBAColorValue): void;
-    /**
-     * 设置字体清晰度
-     * @param value - 字体清晰度
-     * @returns
-     */
-    setFontScale(value: number): void;
     /**
      * 更新文本
-     * @returns
      */
     protected updateTexture(flipY?: boolean): void;
     renderText(options: spec.TextContentOptions): void;
@@ -115,7 +73,7 @@ export declare class TextComponent extends MaskableGraphic implements ITextCompo
         padT: number;
         padB: number;
     };
-    setAutoWidth(value: boolean): void;
+    setAutoResize(value: spec.TextSizeMode): void;
     /**
      * 设置文本框宽度
      * 手动设置宽度时会自动关闭 `autoWidth`
@@ -128,16 +86,58 @@ export declare class TextComponent extends MaskableGraphic implements ITextCompo
      * @param value - 文本框高度
      */
     setTextHeight(value: number): void;
+    /**
+     * 设置字体大小
+     * @param value - 字体大小
+     * @default 40
+     */
     setFontSize(value: number): void;
+    /**
+     * 设置描边宽度
+     * @param value - 描边宽度
+     * @default 0
+     */
     setOutlineWidth(value: number): void;
     /**
      * 设置是否启用文本描边
      * @param value - 是否启用描边
-     * @returns
      */
     setOutlineEnabled(value: boolean): void;
+    /**
+     * 设置阴影模糊度
+     * @param value - 阴影模糊度
+     * @default 0
+     */
     setShadowBlur(value: number): void;
+    /**
+     * 设置阴影颜色
+     * > setupShadow 使用 outlineColor 作为阴影颜色，更新 shadowColor 不影响阴影颜色
+     * @param value - 阴影颜色
+     * @returns
+     */
     setShadowColor(value: spec.RGBAColorValue): void;
+    /**
+     * 设置阴影偏移 X
+     * @param value - 阴影偏移值
+     * @returns
+     */
     setShadowOffsetX(value: number): void;
+    /**
+     * 设置阴影偏移 Y
+     * @param value - 阴影偏移值
+     * @returns
+     */
     setShadowOffsetY(value: number): void;
+    /**
+     * 计算文本在当前样式与布局规则下的建议宽度（逻辑像素）。
+     *
+     * 说明：
+     * - 使用 Canvas 2D 的 measureText，并按当前实现的逐字符排版规则累加宽度（与 updateTexture 保持一致）。
+     * - 结果为"逻辑宽度"（已除去 fontScale，并扣除 fontOffset），可直接写回 options.textWidth。
+     * - 通过 padding 追加少量冗余像素，用于降低边缘裁切风险。
+     *
+     * @returns 文本宽度（>= 0）
+     */
+    getTextWidth(): number;
+    private getDefaultProps;
 }

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

@@ -8,15 +8,14 @@ export declare class TextLayout implements BaseLayout {
     overflow: spec.TextOverflow;
     width: number;
     height: number;
-    /**
-     * 自适应宽高开关
-     */
-    autoWidth: boolean;
-    maxTextWidth: number;
     /**
      * 行高
      */
     lineHeight: number;
+    /**
+     * 自动宽高模式
+     */
+    autoResize: spec.TextSizeMode;
     constructor(options: spec.TextContentOptions);
     update(options: spec.TextContentOptions): void;
     /**

package/dist/plugins/timeline/playable.d.ts

@@ -56,5 +56,6 @@ export interface FrameContext {
 }
 export declare enum PlayState {
     Playing = 0,
-    Paused = 1
+    Paused = 1,
+    Stopped = 2
 }

package/dist/plugins/timeline/timeline-asset.d.ts

@@ -14,13 +14,9 @@ export declare class TimelineAsset extends EffectsObject {
     private addSubTracksRecursive;
 }
 export declare class TimelineInstance {
-    private time;
     private clips;
-    private masterTrackInstances;
     constructor(timelineAsset: TimelineAsset, sceneBindings: SceneBinding[]);
-    setTime(time: number): void;
-    getTime(): number;
-    evaluate(deltaTime: number): void;
+    evaluate(time: number, deltaTime: number): void;
     compileTracks(tracks: TrackAsset[], sceneBindings: SceneBinding[]): void;
     private tickTrack;
     private updateTrackAnimatedObject;

package/dist/plugins/timeline/track.d.ts

@@ -1,6 +1,5 @@
 import * as spec from '@galacean/effects-specification';
 import { Playable, PlayableAsset, PlayableOutput } from './playable';
-import { ParticleSystem } from '../particle/particle-system';
 import type { Constructor } from '../../utils';
 import { TrackMixerPlayable } from './playables';
 /**
@@ -56,10 +55,8 @@ export declare class RuntimeClip {
     clip: TimelineClip;
     playable: Playable;
     parentMixer: TrackMixerPlayable;
-    private particleSystem;
     constructor(clip: TimelineClip, clipPlayable: Playable, parentMixer: TrackMixerPlayable);
     set enable(value: boolean);
-    getParticleSystem(): ParticleSystem;
     evaluateAt(localTime: number): void;
 }
 /**

package/dist/precompositions/index.d.ts

@@ -0,0 +1,2 @@
+export * from './precomposition';
+export * from './precomposition-manager';

package/dist/precompositions/precomposition-manager.d.ts

@@ -0,0 +1,13 @@
+import type { Composition } from '../composition';
+import { VFXItem } from '../vfx-item';
+import type { Precomposition } from './precomposition';
+export declare class PrecompositionManager {
+    /**
+     * 从预合成数据实例化一棵 VFXItem 树。
+     * 可挂载到现有合成的节点下。
+     * @param precomposition 预合成数据
+     * @param composition 目标合成
+     * @returns 实例化生成的根 VFXItem，其子树包含指定合成的所有元素
+     */
+    static instantiate(precomposition: Precomposition, composition: Composition): VFXItem;
+}

package/dist/precompositions/precomposition.d.ts

@@ -0,0 +1,7 @@
+import type { Scene, SceneLoadOptions } from '../scene';
+/**
+ * 预合成数据类，包含预合成 Json 数据和加载选项。
+ */
+export declare class Precomposition {
+    constructor(scene: Scene, options?: SceneLoadOptions);
+}

package/dist/render/graphics.d.ts

@@ -0,0 +1,136 @@
+import { Color } from '@galacean/effects-math/es/core/color';
+import { Matrix3 } from '@galacean/effects-math/es/core/matrix3';
+import type { Engine } from '../engine';
+export declare class Graphics {
+    private engine;
+    private geometry;
+    private material;
+    private graphicsPath;
+    private vertices;
+    private colors;
+    private indices;
+    private lineStyle;
+    private transformStack;
+    private currentTransform;
+    private get currentVertexCount();
+    private get currentIndexCount();
+    constructor(engine: Engine);
+    /**
+     * 清空缓冲区，准备新的绘制批次
+     */
+    begin(): void;
+    /**
+     * 将当前变换压入栈，并设置新的变换
+     * @param transform - 新的变换矩阵（会与当前变换相乘）
+     */
+    pushTransform(transform: Matrix3): void;
+    /**
+     * 恢复上一个变换
+     */
+    popTransform(): void;
+    /**
+     * 刷新并渲染所有累积的绘制命令
+     */
+    end(): void;
+    /**
+     * 线段顶点按顺序连接 (p0-p1, p1-p2, p2-p3, ...)
+     * @param points - 点数组，格式 [x1,y1,x2,y2,...]，至少需要2个点（4个数值）
+     * @param color - 线条颜色，范围 0-1
+     * @param thickness - 线宽（像素）
+     */
+    drawLines(points: number[], color?: Color, thickness?: number): void;
+    /**
+     * 绘制单条线段
+     * @param x1 - 起点x
+     * @param y1 - 起点y
+     * @param x2 - 终点x
+     * @param y2 - 终点y
+     * @param color - 线条颜色
+     * @param thickness - 线宽
+     */
+    drawLine(x1: number, y1: number, x2: number, y2: number, color?: Color, thickness?: number): void;
+    /**
+     * 绘制贝塞尔曲线
+     * @param x1 - 起点x
+     * @param y1 - 起点y
+     * @param x2 - 控制点1x
+     * @param y2 - 控制点1y
+     * @param x3 - 控制点2x
+     * @param y3 - 控制点2y
+     * @param x4 - 终点x
+     * @param y4 - 终点y
+     * @param color - 线条颜色
+     * @param thickness - 线宽
+     */
+    drawBezier(x1: number, y1: number, x2: number, y2: number, x3: number, y3: number, x4: number, y4: number, color?: Color, thickness?: number): void;
+    /**
+     * 绘制三角形边框
+     * @param x1 - 顶点1x
+     * @param y1 - 顶点1y
+     * @param x2 - 顶点2x
+     * @param y2 - 顶点2y
+     * @param x3 - 顶点3x
+     * @param y3 - 顶点3y
+     * @param color - 线条颜色
+     * @param thickness - 线宽
+     */
+    drawTriangle(x1: number, y1: number, x2: number, y2: number, x3: number, y3: number, color?: Color, thickness?: number): void;
+    /**
+     * 绘制矩形边框
+     * @param x - 矩形左下角 X 坐标
+     * @param y - 矩形左下角 Y 坐标
+     * @param width - 矩形宽度
+     * @param height - 矩形高度
+     * @param color - 矩形颜色
+     */
+    drawRectangle(x: number, y: number, width: number, height: number, color?: Color, thickness?: number): void;
+    /**
+     * 绘制圆形边框
+     * @param cx - 圆心x
+     * @param cy - 圆心y
+     * @param radius - 半径
+     * @param color - 线条颜色
+     * @param thickness - 线宽
+     */
+    drawCircle(cx: number, cy: number, radius: number, color?: Color, thickness?: number): void;
+    /**
+     * 绘制填充三角形
+     * @param x1 - 顶点1x
+     * @param y1 - 顶点1y
+     * @param x2 - 顶点2x
+     * @param y2 - 顶点2y
+     * @param x3 - 顶点3x
+     * @param y3 - 顶点3y
+     * @param color - 填充颜色
+     */
+    fillTriangle(x1: number, y1: number, x2: number, y2: number, x3: number, y3: number, color?: Color): void;
+    /**
+     * 绘制填充矩形
+     * @param x - 矩形左下角 X 坐标
+     * @param y - 矩形左下角 Y 坐标
+     * @param width - 矩形宽度
+     * @param height - 矩形高度
+     * @param color - 矩形颜色
+     */
+    fillRectangle(x: number, y: number, width: number, height: number, color?: Color): void;
+    /**
+     * 绘制填充圆形
+     * @param cx - 圆心x
+     * @param cy - 圆心y
+     * @param radius - 半径
+     * @param color - 填充颜色
+     */
+    fillCircle(cx: number, cy: number, radius: number, color?: Color): void;
+    dispose(): void;
+    private buildShape;
+    private buildShapeLine;
+    private applyTransformAndColor;
+    /**
+     * 应用自定义变换到点
+     * @param x - 点的 x 坐标
+     * @param y - 点的 y 坐标
+     * @param result - 变换结果存储数组
+     * @param offset - 存储数组的偏移位置
+     */
+    private applyTransform;
+}

package/dist/render/index.d.ts

@@ -9,4 +9,5 @@ export * from './mesh';
 export * from './geometry';
 export * from './framebuffer';
 export * from './renderer';
+export * from './graphics';
 export * from './draw-object-pass';

package/dist/render/render-frame.d.ts

@@ -61,7 +61,7 @@ export declare class RenderFrame implements Disposable {
     /**
      * 当前使用的全部 RenderPass
      */
-    _renderPasses: RenderPass[];
+    renderPasses: RenderPass[];
     /**
      * 渲染时的相机
      */
@@ -82,7 +82,6 @@ export declare class RenderFrame implements Disposable {
     private postProcessingEnabled;
     private enableHDR;
     constructor(options: RenderFrameOptions);
-    get renderPasses(): RenderPass[];
     get isDisposed(): boolean;
     /**
      * 设置 RenderPasses 参数，此函数每帧调用一次

package/dist/scene-loader.d.ts

@@ -1,6 +1,9 @@
 import { Composition } from './composition';
 import type { Engine } from './engine';
 import type { Scene, SceneLoadOptions } from './scene';
+/**
+ * @hidden
+ */
 export declare class SceneLoader {
     static load(scene: Scene.LoadType, engine: Engine, options?: SceneLoadOptions): Promise<Composition>;
     private static createComposition;

package/dist/scene.d.ts

@@ -12,7 +12,6 @@ export interface Scene {
     readonly storage: Record<string, any>;
     renderLevel?: SceneRenderLevel;
     textureOptions: Record<string, any>[];
-    textures: Texture[];
     images: ImageLike[];
     assets: Record<string, ImageLike>;
     consumed?: boolean;

package/dist/vfx-item.d.ts

@@ -1,7 +1,7 @@
 import { Vector3 } from '@galacean/effects-math/es/core/vector3';
 import * as spec from '@galacean/effects-specification';
 import type { Component } from './components';
-import { Composition } from './composition';
+import type { Composition } from './composition';
 import { EffectsObject } from './effects-object';
 import type { Engine } from './engine';
 import type { EventEmitterListener, EventEmitterOptions, ItemEvent } from './events';
@@ -49,10 +49,18 @@ export declare class VFXItem extends EffectsObject implements Disposable {
      * @deprecated 2.7.0 Please use `getInstanceId` instead
      */
     id: string;
+    /**
+     * 元素类型
+     */
     type: spec.ItemType;
+    /**
+     * @deprecated 2.9.0 Please use `defination` instead
+     */
     props: spec.VFXItemData;
+    /**
+     * 元素绑定的组件列表
+     */
     components: Component[];
-    isDuringPlay: boolean;
     /**
      * 元素是否激活
      */
@@ -64,9 +72,6 @@ export declare class VFXItem extends EffectsObject implements Disposable {
     private listIndex;
     private isEnabled;
     private eventProcessor;
-    /**
-     * 合成属性
-     */
     private _composition;
     /**
      *
@@ -127,6 +132,7 @@ export declare class VFXItem extends EffectsObject implements Disposable {
     set composition(value: Composition);
     /**
      * 播放完成后是否需要再使用，是的话生命周期结束后不会 dispose
+     * @deprecated
      */
     get compositionReusable(): boolean;
     /**
@@ -287,8 +293,6 @@ export declare class VFXItem extends EffectsObject implements Disposable {
      */
     dispose(): void;
     private resetChildrenParent;
-    private instantiatePreComposition;
-    private resetGUID;
     private gatherPreviousObjectID;
     private getDescendantsInternal;
 }

package/package.json

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