@galacean/effects-plugin-editor-gizmo 2.10.4 → 2.11.0-alpha.1

package/dist/2d/gizmos/mask-gizmo.d.ts

@@ -0,0 +1,153 @@
+import { Vector2 } from '../math';
+import type { MaskConfig } from '../configs/types';
+import type { VFXItem } from '@galacean/effects';
+import { type InputEventMouseButton, type InputEventMouseMotion } from '@galacean/effects';
+import type { Control } from '@galacean/effects-plugin-gui';
+import { Gizmo } from '../gizmo';
+import type { GizmoOwner } from '../gizmo-owner';
+import { GizmoType } from '../gizmo-type';
+import { type GestureCursorResult } from '../cursor';
+/**
+ * 图片蒙版工具结果
+ */
+export type MaskResult = {
+    /**
+     * 蒙版线条列表
+     */
+    lines: {
+        /** 笔刷大小 */
+        brushSize: number;
+        /** 笔刷路径点（归一化坐标） */
+        points: Vector2[];
+        /** 笔刷类型：涂抹或擦除 */
+        type?: 'paint' | 'erase';
+        /** 形状类型：'stroke' 折线（默认），'rect' 矩形框选（points=[起点, 终点]） */
+        shape?: 'stroke' | 'rect';
+    }[];
+};
+/** 通过笔刷或矩形涂抹、擦除图片蒙版并实时预览。 */
+export declare class MaskGizmo extends Gizmo {
+    /** gizmo 类型标识 */
+    type: GizmoType;
+    /** 当前笔刷模式：涂抹或擦除 */
+    mode: 'paint' | 'erase' | 'box-paint' | 'box-erase';
+    /** 光标结果。 */
+    cursorResult: GestureCursorResult;
+    result: MaskResult;
+    /** 配置变更退订函数。 */
+    private configOff?;
+    /** 当前已加载的黑白蒙版图片。 */
+    private maskImage?;
+    /** 蒙版图片加载版本，用于丢弃过期异步结果。 */
+    private maskImageLoadVersion;
+    /** 仅供 draw 使用，由 onUpdate 为当前帧生成。 */
+    private renderTransform?;
+    /** 离屏 canvas，用于绘制蒙版预览（笔刷涂抹/擦除，原生支持圆头与 destination-out）。 */
+    private previewCanvas;
+    /** 蒙版预览纹理（由离屏 canvas 每帧上传）。 */
+    private maskTexture;
+    private mouseGrabbed;
+    /**
+     * 创建蒙版 Gizmo，并按当前配置加载基础蒙版图。
+     * @param owner Gizmo 宿主。
+     */
+    constructor(owner: GizmoOwner);
+    /** 当前选中的元素（直读 selection.getSelectedPlayerItems：id→VFXItem 已解析）。 */
+    get selectedItems(): VFXItem[];
+    /** 当前蒙版配置。 */
+    get config(): Readonly<MaskConfig>;
+    /**
+     * 更新蒙版绘制或指针光标。
+     * @param event 鼠标移动事件。
+     */
+    onMouseMove(event: InputEventMouseMotion): void;
+    /**
+     * 继续当前蒙版绘制交互。
+     * @param event 鼠标拖拽事件。
+     */
+    onMouseDrag(event: InputEventMouseMotion): void;
+    /**
+     * 在选中元素内开始笔刷或矩形蒙版交互。
+     * @param event 鼠标按下事件。
+     */
+    onMouseDown(event: InputEventMouseButton): void;
+    /**
+     * 结束蒙版绘制并移除无效路径。
+     * @param event 鼠标抬起事件。
+     */
+    onMouseUp(event: InputEventMouseButton): void;
+    /** 释放预览纹理和离屏绘制资源。 */
+    dispose(): void;
+    /** 为本帧绘制创建元素包围盒快照。 */
+    onUpdate(): void;
+    /**
+     * 绘制蒙版纹理、元素轮廓和矩形预览。
+     * @param control 绘制控制器。
+     */
+    draw(control: Control): void;
+    /**
+     * 设置模式。
+     * @param mode 模式类型：'paint' 笔刷涂抹、'erase' 笔刷擦除、'box-paint' 框选涂抹、'box-erase' 框选擦除
+     */
+    setMode(mode: 'paint' | 'erase' | 'box-paint' | 'box-erase'): void;
+    /** 关闭 gizmo：清空蒙版配置、笔刷和预览资源。 */
+    close(): void;
+    /** 清空当前所有笔刷线条。 */
+    clearMask(): void;
+    /**
+     * 加载蒙版图片。
+     * @param url 图片地址
+     * @returns Promise<HTMLImageElement>
+     */
+    loadMaskImage(url: string): Promise<HTMLImageElement>;
+    /**
+     * 生成当前蒙版的 PNG Canvas。
+     * @returns 蒙版图像；没有有效蒙版时返回 null。
+     */
+    getMask(): HTMLCanvasElement | null;
+    /**
+     * 生成当前蒙版的 PNG Data URL。
+     * @returns 蒙版图像；没有有效蒙版时返回 undefined。
+     */
+    getMaskDataUrl(): string | undefined;
+    /**
+     * 在蒙版图片 URL 变化时刷新运行时图片。
+     * @param change 蒙版配置变更。
+     */
+    private onConfigChange;
+    /**
+     * 加载当前配置指定的蒙版图片，并忽略已过期的异步结果。
+     * @param url 蒙版图片 URL；空字符串表示清空。
+     */
+    private refreshMaskImage;
+    /**
+     * 更新当前笔刷路径或矩形终点。
+     * @param event 鼠标拖拽事件。
+     * @param transform 当前元素投影。
+     * @returns 是否处理了拖拽。
+     */
+    private updateGrab;
+    /**
+     * 将视口坐标转换为包围盒内的归一化坐标。
+     * @param p 视口坐标。
+     * @param transform 元素 Box2 投影。
+     * @returns 钳制到 [0, 1] 的归一化坐标。
+     */
+    private toNormalized;
+    /** 按当前元素与视口即时计算投影，不写入业务状态或渲染快照。 */
+    private getSelectionTransform;
+    /** 释放预览纹理与离屏 canvas。 */
+    private clearRenderObjects;
+    /**
+     * 将蒙版预览绘制到离屏画布。
+     * @param width 预览宽度。
+     * @param height 预览高度。
+     * @returns 离屏画布；创建失败时返回 null。
+     */
+    private renderPreviewToCanvas;
+    /**
+     * 根据指针位置和蒙版模式刷新光标。
+     * @param transform 当前元素投影。
+     */
+    private refreshCursorResult;
+}

package/dist/2d/gizmos/move-selection-gizmo.d.ts

@@ -0,0 +1,64 @@
+import { type InputEventMouseButton, type InputEventMouseMotion } from '@galacean/effects';
+import type { Control } from '@galacean/effects-plugin-gui';
+import { Gizmo } from '../gizmo';
+import { type AutoLayoutChangeInfo, type SelectionPlacementChange } from '../frame/frame-assisted-layout';
+/** 拖动选中对象，并处理吸附、重挂载和自动布局。 */
+export declare class MoveSelectionGizmo extends Gizmo {
+    readonly type = "move-selection";
+    private active;
+    private selectedItems;
+    private selectionBox;
+    private interactionPlane;
+    private startPoint;
+    private lastPoint;
+    private cursorPoint;
+    private lastWorldPosition;
+    private assistedLayout;
+    /**
+     * 在选区内按下主键时开始移动交互。
+     * @param event 鼠标按下事件。
+     */
+    onMouseDown(event: InputEventMouseButton): void;
+    /**
+     * 忽略未进入拖拽阶段的移动事件。
+     * @param _event 鼠标移动事件。
+     */
+    onMouseMove(_event: InputEventMouseMotion): void;
+    /**
+     * 移动选中对象并更新布局辅助状态。
+     * @param event 鼠标拖拽事件。
+     */
+    onMouseDrag(event: InputEventMouseMotion): void;
+    /**
+     * 结束移动并提交布局与变换结果。
+     * @param event 鼠标抬起事件。
+     */
+    onMouseUp(event: InputEventMouseButton): void;
+    /**
+     * 绘制移动过程中的布局辅助信息。
+     * @param control 绘制控制器。
+     */
+    draw(control: Control): void;
+    /**
+     * 将视口位移应用到选中对象。
+     * @param shift 本次视口位移。
+     * @returns 是否成功应用位移。
+     */
+    private applyTranslation;
+    /**
+     * 初始化移动所需的选区、吸附目标与交互平面。
+     * @returns 是否成功准备交互几何信息。
+     */
+    private prepareTranslationGeometry;
+    /**
+     * 计算当前可见选中项的视口包围盒。
+     * @param containerSize 视口容器尺寸。
+     * @returns 选区包围盒。
+     */
+    private computeSelectionBox;
+    /** 按当前父级关系刷新本次移动可用的吸附目标。 */
+    private cacheSnapTargets;
+    /** 重置移动交互状态。 */
+    private resetDragState;
+}
+export type { AutoLayoutChangeInfo, SelectionPlacementChange };

package/dist/2d/gizmos/resize-selection-gizmo/anchored-resize.d.ts

@@ -0,0 +1,40 @@
+import type { Matrix4 } from '../../math';
+import { Vector3 } from '../../math';
+/** 一次锚定缩放在 pointer down 时冻结的几何。 */
+export type AnchoredResizeGeometry = {
+    /** 初始被拖手柄位置（世界坐标）。 */
+    initialHandle: Vector3;
+    /** 始终保持不动的对边中点或对角点（世界坐标）。 */
+    fixedPoint: Vector3;
+    /** 属性变化实际围绕的原点（transform scale 用 anchor，内容 size 用几何中心）。 */
+    resizeOrigin: Vector3;
+    /** 世界向量到元素局部缩放轴的旋转矩阵（无平移）。 */
+    worldToLocalRotation: Matrix4;
+};
+/** 锚定缩放约束。 */
+export type AnchoredResizeOptions = {
+    /** 边只控制一个轴；角点同时控制两个轴。 */
+    handleKind: 'edge' | 'corner';
+    /** 是否锁定宽高比。 */
+    lockAspectRatio: boolean;
+    /** 强制保持不变的局部缩放轴。 */
+    lockedAxis?: 'x' | 'y';
+};
+/** 锚定缩放的绝对变换结果。 */
+export type AnchoredResizeResult = {
+    /** 相对 pointer down 快照的总缩放，而非相对上一帧的增量。 */
+    totalScalar: Vector3;
+    /** 相对 pointer down 快照的总世界位移。 */
+    totalTranslation: Vector3;
+};
+/**
+ * 由初始快照计算当前边或角点缩放的绝对结果。
+ *
+ * 当前指针决定“固定点 → 手柄”的有符号比例；属性绕其真实 resizeOrigin 变化，
+ * 再反算位移使 fixedPoint 回到原坐标。
+ * @param geometry 交互开始时冻结的几何
+ * @param pointer 当前指针世界坐标
+ * @param options 手柄类型和比例约束
+ * @returns 相对交互起点的绝对缩放和位移
+ */
+export declare function calculateAnchoredResize(geometry: AnchoredResizeGeometry, pointer: Vector3, options: AnchoredResizeOptions): AnchoredResizeResult;

package/dist/2d/gizmos/resize-selection-gizmo/index.d.ts

@@ -0,0 +1,2 @@
+export * from './transform-types';
+export * from './resize-selection-gizmo';

package/dist/2d/gizmos/resize-selection-gizmo/resize-selection-gizmo.d.ts

@@ -0,0 +1,364 @@
+import type { VFXItem } from '@galacean/effects';
+import { type InputEventKey, type InputEventMouseButton, type InputEventMouseMotion } from '@galacean/effects';
+import type { Control } from '@galacean/effects-plugin-gui';
+import type { Plane } from '@galacean/effects-math/es/extension/index';
+import { Box2, Circle, Line2 } from '@galacean/effects-math/es/extension/index';
+import type { Matrix3 } from '../../math';
+import { Vector2, Vector3 } from '../../math';
+import { Gizmo } from '../../gizmo';
+import type { GizmoOwner } from '../../gizmo-owner';
+import { GizmoType } from '../../gizmo-type';
+import { type GestureCursorResult } from '../../cursor';
+import type { ResizeSelectionConfig } from '../../configs/types';
+import { TransformType } from './transform-types';
+/** 单选信息标签的元素图标类型。 */
+export declare enum ResizeSelectionIconType {
+    /** 图片。 */
+    IMAGE = "image",
+    /** 组合。 */
+    GROUP = "group",
+    /** 文本。 */
+    TEXT = "text",
+    /** 视频。 */
+    VIDEO = "video",
+    /** 动效。 */
+    EFFECTS = "effects",
+    /** 画板。 */
+    FRAME = "frame",
+    /** 不显示图标。 */
+    NULL = "null"
+}
+/** 缩放角点的桌面端命中区域边长；视觉手柄仍由 scaleCircleSize 控制。 */
+export declare const SCALE_CORNER_HIT_SIZE = 14;
+/** 缩放选区 Gizmo 的交互配置。 */
+export type ResizeSelectionGizmoOptions = {
+    /** 是否允许缩放；关闭时仍绘制选区线框。 */
+    interactive?: boolean;
+};
+/** 绘制选区线框，并通过边与角点手柄缩放选中元素。 */
+export declare class ResizeSelectionGizmo extends Gizmo {
+    readonly type: GizmoType;
+    /** 光标结果。 */
+    cursorResult: GestureCursorResult;
+    /** 当前光标视图坐标，用于绘制指针与变换原点，每 mousemove 更新。 */
+    cursorPoint: Vector2;
+    /** ResizeSelection 手柄上一帧的 Control 本地坐标，用于缩放位移增量计算。 */
+    lastPoint: Vector2;
+    /** 变换框线框数据。 */
+    wireframe: ResizeSelectionWireframe;
+    /** 交互类型。 */
+    activeType: TransformType;
+    /** 上一帧鼠标射线碰撞位置。 */
+    lastWorldPosition: Vector3;
+    /** 是否为锁定比例缩放。 */
+    _isLockScale: boolean;
+    /** 当前交互平面，initInteractionPlane 写入。 */
+    interactionPlane: Plane;
+    private configOff?;
+    /** 边与角点共用一次绝对缩放快照。 */
+    private resizeSession;
+    /** ResizeSelection 自身的缩放手柄是否持有输入；移动与角旋转由独立行为持有。 */
+    private handlesActive;
+    /** 是否忽略所有交互。 */
+    private _ignoreInteraction;
+    /** 当前单选元素的图标类型。 */
+    private iconType;
+    /** 类型图标纹理缓存（懒加载，URL 变化时刷新）。 */
+    private iconTextures;
+    /** 类型图标纹理加载中的 Promise，避免重复发起加载。 */
+    private iconTexturePromises;
+    /** 缩放开关。 */
+    private scaleEnabled;
+    /** 是否允许当前 Gizmo 接收缩放输入。 */
+    private readonly interactionEnabled;
+    /**
+     * 创建选区缩放 Gizmo 并监听配置变化。
+     * @param owner Gizmo 宿主。
+     * @param options 缩放交互配置。
+     */
+    constructor(owner: GizmoOwner, options?: ResizeSelectionGizmoOptions);
+    /** 选中的元素列表（直读 selection）。 */
+    get selectedItems(): VFXItem[];
+    /** 当前选区缩放配置。 */
+    get config(): Readonly<ResizeSelectionConfig>;
+    /** 取是否锁定比例缩放。 */
+    get isLockScale(): boolean;
+    /**
+     * 设置锁定比例缩放开关。
+     * @param state 是否锁定比例。
+     */
+    set isLockScale(state: boolean);
+    /** 取当前视口矩阵的水平缩放系数。 */
+    get viewScale(): number;
+    /** 取是否忽略所有交互。 */
+    get ignoreInteraction(): boolean;
+    /**
+     * 设置是否忽略交互，并同步角点可用状态。
+     * @param state 是否忽略交互。
+     */
+    set ignoreInteraction(state: boolean);
+    /**
+     * 忽略键盘按下，修饰键状态由鼠标事件提供。
+     * @param _keyCode 键盘按下事件。
+     */
+    onKeyDown(_keyCode: InputEventKey): void;
+    /**
+     * 忽略键盘抬起，修饰键状态由鼠标事件提供。
+     * @param _keyCode 键盘抬起事件。
+     */
+    onKeyUp(_keyCode: InputEventKey): void;
+    /**
+     * 更新缩放手柄拖拽或悬停命中状态。
+     * @param event 鼠标移动事件。
+     */
+    onMouseMove(event: InputEventMouseMotion): void;
+    /**
+     * 继续当前缩放手柄拖拽。
+     * @param event 鼠标拖拽事件。
+     */
+    onMouseDrag(event: InputEventMouseMotion): void;
+    /** 鼠标离开交互层时清除非拖拽状态下的手柄命中与光标。 */
+    onMouseLeave(): void;
+    /**
+     * 命中缩放手柄时开始变换会话。
+     * @param event 鼠标按下事件。
+     */
+    onMouseDown(event: InputEventMouseButton): void;
+    /**
+     * 结束当前缩放手柄拖拽。
+     * @param event 鼠标抬起事件。
+     */
+    onMouseUp(event: InputEventMouseButton): void;
+    /**
+     * 刷新指针结果。
+     * @param activeType 交互类型
+     * @param angle 指针角度
+     */
+    refreshCursorResult(activeType: TransformType, angle?: number): void;
+    /** 在每帧更新时刷新选区线框及失效的光标状态。 */
+    onUpdate(): void;
+    /**
+     * 根据鼠标点位置判定当前交互类型（缩放/平移），
+     * 并写入 activeType 与线框的交互方向、缩放角点；未命中则置 NULL。
+     * @param point 视口坐标
+     */
+    refreshTransformType(point: Vector2): void;
+    /**
+     * 根据选中元素刷新变换线框：计算包围盒、子元素盒与缩放角点；
+     * 单选时根据元素类型决定图标类型；成组不生成缩放角点。
+     */
+    refreshWireframeBySelectedItems(): void;
+    /**
+     * 初始化当前变换的交互平面与缩放会话。
+     * @param viewportPoint 指针视口坐标。
+     */
+    initInteractionPlane(viewportPoint: Vector2): void;
+    /**
+     * 绘制选区线框、缩放手柄与单选信息标签。
+     * @param control 绘制控制器。
+     */
+    draw(control: Control): void;
+    /** 释放配置监听器。 */
+    dispose(): void;
+    /** @returns 当前是否存在可操作的选中元素。 */
+    private isApplicableSelection;
+    /** @returns 当前选区是否包含处于 loading 状态的元素。 */
+    private hasLoadingSelection;
+    /** 清除缩放手柄悬停状态并恢复默认光标。 */
+    private clearHandleHover;
+    /**
+     * 根据指针位移更新缩放手柄交互。
+     * @param event 鼠标拖拽事件。
+     * @returns 是否处理了拖拽。
+     */
+    private updateHandleDrag;
+    /** 初始化一次变换算法需要的视口交互平面；事件由持有输入会话的 Gizmo 发出。 */
+    private beginTransformOperation;
+    /** 清理一次变换算法运行态，不改写当前线框命中类型。 */
+    private resetTransformOperation;
+    /**
+     * 提交缩放手柄拖拽并清理会话。
+     * @param event 鼠标抬起事件。
+     * @returns 是否完成了提交。
+     */
+    private finishHandleDrag;
+    /**
+     * 按最终指针位置刷新线框命中与光标。
+     * @param _event 鼠标抬起事件。
+     */
+    private refreshAfterPointerUp;
+    /**
+     * 获取元素的信息标签图标类型。
+     * @param item 播放器元素。
+     * @returns 图标类型。
+     */
+    private getIconType;
+    /**
+     * 获取元素的信息标签名称。
+     * @param item 播放器元素。
+     * @returns 显示名称。
+     */
+    private getItemInfoName;
+    /** @returns 当前选框在视口中的局部单位轴。 */
+    private boxLocalAxes;
+    /**
+     * 查找文本宽度交互正在拖动的边。
+     * @param center 选框中心。
+     * @param interactiveDirection 交互方向。
+     * @returns 当前被拖动的边。
+     */
+    private draggedWidthEdge;
+    /** 是否为单个文字元素选区。 */
+    private isSingleTextSelection;
+    /**
+     * 命中线框边缩放区域。角点由调用方优先判定，边命中采用到线段的屏幕距离，
+     * 因而旋转元素也沿真实边工作，而不是沿轴对齐 AABB 工作。
+     * @param point 视口指针
+     * @param textVerticalOnly 单文本时只开放上/下边；左/右边保留给文字宽度手柄
+     */
+    private findScaleEdge;
+    /**
+     * 查找指针命中的缩放角点。
+     * @param point 指针视口坐标。
+     * @returns 命中的缩放角点。
+     */
+    private findScaleCorner;
+    /**
+     * 获取被拖边对边的中点。
+     * @param scaleEdgeCorners 被拖边的两个端点。
+     * @returns 对边中点。
+     */
+    private oppositeScaleEdgeCenter;
+    /**
+     * 获取被拖角点的对角点。
+     * @param scaleCorner 被拖角点。
+     * @returns 对角点。
+     */
+    private oppositeScaleCorner;
+    /**
+     * 创建按下时冻结的绝对缩放会话。
+     * @param item 被缩放元素。
+     * @param itemMatrix 元素世界矩阵。
+     * @param transformOrigin 变换原点。
+     * @param viewportPoint 指针视口坐标。
+     * @param initialHandleView 初始手柄视口位置。
+     * @param fixedPointView 固定点视口位置。
+     * @param handleKind 手柄类型。
+     * @param textResizeMode 文本缩放模式。
+     * @returns 缩放会话；坐标转换失败时返回 undefined。
+     */
+    private createAnchoredResizeSession;
+    /**
+     * 按 ResizeSelectionIconType 取对应配置的图标 URL。
+     * @param type 图标类型
+     * @returns 图标 URL；NULL 类型返回空字符串
+     */
+    private getIconUrl;
+    /**
+     * 配置变更时刷新类型图标纹理：URL 变化的图标销毁旧纹理并清空缓存，
+     * 下次 draw 时会按新 URL 懒加载。
+     * @param previous 变更前配置
+     * @param current 变更后配置
+     */
+    private refreshIconSprites;
+    /**
+     * 根据配置变化刷新图标纹理缓存。
+     * @param change 选区缩放配置变更。
+     */
+    private onConfigChange;
+    /**
+     * 获取类型图标纹理（懒加载）。
+     * 命中且未销毁则直接返回；否则发起一次异步加载并返回 undefined（本帧跳过图标，
+     * 加载完成后由持续渲染循环自动重绘）。
+     * @param type 图标类型
+     * @param engine effects 引擎实例（取自 control）
+     * @returns 命中的纹理；未命中或加载中时返回 undefined
+     */
+    private getIconTexture;
+    /**
+     * 绘制单选元素的名称、尺寸与类型图标。
+     * @param control 绘制控制器。
+     * @param sizeTextColor 尺寸文本颜色。
+     * @param nameTextColor 名称文本颜色。
+     */
+    private renderItemInfo;
+    /**
+     * 纯判定：鼠标点命中的交互类型（缩放/平移），未命中返回 NULL。
+     * 只读，不写 activeType/wireframe。供 refreshTransformType 复用。
+     * @param point 视口坐标
+     */
+    private computeTransformType;
+    /**
+     * 处理角点或边缩放交互。
+     * @param shift 本次鼠标位移增量。
+     * @param interactiveDirection 交互方向向量。
+     * @param event 鼠标拖拽事件。
+     * @returns 光标旋转角度。
+     */
+    private handleScale;
+    /**
+     * 根据按下快照计算并应用绝对缩放。
+     * @param pointerView 当前指针视口位置。
+     * @param interactiveDirection 初始交互方向。
+     * @param event 鼠标拖拽事件。
+     * @returns 光标旋转角度。
+     */
+    private handleAnchoredResize;
+    /**
+     * 将绝对缩放结果应用到会话快照。
+     * @param session 缩放会话。
+     * @param resize 绝对缩放结果。
+     */
+    private applyAnchoredResize;
+    /**
+     * 将世界总位移转换到父级局部坐标并写入位置。
+     * @param session 缩放会话。
+     * @param totalWorldTranslation 世界空间累计位移。
+     */
+    private setResizePosition;
+    /**
+     * 处理文本左右边的宽度缩放。
+     * @param shift 本次鼠标位移增量。
+     * @param interactiveDirection 交互方向向量。
+     * @param event 鼠标拖拽事件。
+     * @returns 光标旋转角度。
+     */
+    private handleWidthScale;
+    /**
+     * 将手柄位置吸附到最近目标。
+     * @param point 原始手柄位置。
+     * @returns 吸附后的手柄位置。
+     */
+    private snapHandlePoint;
+}
+/** 选区线框的视口几何与交互状态。 */
+export type ResizeSelectionWireframe = {
+    /** 线框四条边 */
+    edges: Line2[];
+    /** 主线框归一化 Box2 到视图的变换 */
+    transform?: Matrix3;
+    /** 缩放角点碰撞圆 */
+    scaleCorners: Circle[];
+    /** 单文本左右两侧的宽度调整手柄 */
+    widthScaleAreas: Matrix3[];
+    /** 线框是否可交互 */
+    interactive: boolean;
+    /** 角点是否可点 */
+    cornerEnable: boolean;
+    /** 当前元素包围盒 */
+    box: Box2;
+    /** 变换锚点 */
+    anchor: Vector2;
+    /** 命中外扩包围盒（含角点区域） */
+    totalBox: Box2;
+    /** 多选时子元素的视图变换 */
+    childrenTransforms: Matrix3[];
+    /** 当前交互类型 */
+    activeType: TransformType;
+    /** 交互方向向量 */
+    interactiveDirection: Vector2;
+    /** 命中的缩放角点 */
+    scaleCorner?: Vector2;
+    /** 命中的缩放边的两端角点 */
+    scaleEdgeCorners?: Vector2[];
+};

package/dist/2d/gizmos/resize-selection-gizmo/transform-types.d.ts

@@ -0,0 +1,27 @@
+import type { Vector2, Vector3 } from '../../math';
+/** 选区变换的语义类型；由移动、缩放与角旋转行为共同用于命令事务。 */
+export declare enum TransformType {
+    /** 无变换。 */
+    NULL = "null",
+    /** 位移。 */
+    TRANSLATION = "translation",
+    /** 旋转。 */
+    ROTATION = "rotation",
+    /** 双轴缩放。 */
+    SCALE = "scale",
+    /** 文本宽度缩放。 */
+    WIDTH_SCALE = "width-scale"
+}
+/** 选区缩放会话数据。 */
+export type ScaleParam = {
+    /** 变换中心。 */
+    center: Vector3;
+    /** 当前手柄位置。 */
+    corner: Vector3;
+    /** 指针相对位移。 */
+    shift: Vector3;
+    /** 上一帧缩放量。 */
+    lastScalar: Vector3;
+    /** 距中心最远的角点。 */
+    farthestCorner: Vector2;
+};