dxfview 0.0.4-beta.10 → 0.0.4-beta.11

package/dist/types/core/geometry-offset/Offset.d.ts

@@ -32,11 +32,11 @@ export declare class Offset {
     /**
      * Decides by the sign if it's a padding or a margin
      */
-    offset(dist: number): Pair | Ring | Polygon | MultiPolygon;
+    offset(dist: number): MultiPolygon | Polygon | Ring | Pair;
     private offsetSegment;
     private margin;
     private padding;
-    offsetLine(dist: number): Pair | Ring | Polygon | MultiPolygon;
+    offsetLine(dist: number): MultiPolygon | Polygon | Ring | Pair;
     /**
      * Just offsets lines, no fill
      */

package/dist/types/plugins/annotation/AnnotationPlugin.d.ts

@@ -13,6 +13,8 @@ export declare class AnnotationPlugin extends Plugin {
     private snapToleranceInPixel;
     private annotations;
     private activeAnnotationType;
+    private subtractMode;
+    private additionMode;
     private mobileTouchHelper?;
     private selectedMaskColor?;
     private readonly partitionLabels;
@@ -108,6 +110,30 @@ export declare class AnnotationPlugin extends Plugin {
      * @returns {boolean} Is annotating now
      */
     isAnnotating(): boolean;
+    /**
+     * 设置挖空模式（减去图形模式）
+     * @param enabled 是否启用挖空模式
+     * @description {en} Sets subtract mode. When enabled, drawing a new shape inside an existing annotation will subtract/cut out that area.
+     * @description {zh} 设置挖空模式。启用后，在现有标注内绘制新图形将从原标注中减去该区域。
+     */
+    setSubtractMode(enabled: boolean): void;
+    /**
+     * 获取当前挖空模式状态
+     * @returns {boolean} 是否启用挖空模式
+     */
+    getSubtractMode(): boolean;
+    /**
+     * 设置添加模式（合并图形模式）
+     * @param enabled 是否启用添加模式
+     * @description {en} Sets addition mode. When enabled, drawing a new shape that intersects existing annotations will merge/union them together.
+     * @description {zh} 设置添加模式。启用后，绘制与现有标注相交的新图形将合并它们。
+     */
+    setAdditionMode(enabled: boolean): void;
+    /**
+     * 获取当前添加模式状态
+     * @returns {boolean} 是否启用添加模式
+     */
+    getAdditionMode(): boolean;
     /**
      *
      * @returns {AnnotationData[]}
@@ -121,6 +147,11 @@ export declare class AnnotationPlugin extends Plugin {
      */
     cancel(): void;
     private getLastDrawable;
+    /**
+     * 公开的撤回方法，和 Ctrl+Z 的逻辑一致
+     * 用于工具栏撤回按钮调用
+     */
+    undo(): void;
     /**
      *
      * @param {AnnotationData[]} dataArray
@@ -150,6 +181,10 @@ export declare class AnnotationPlugin extends Plugin {
      */
     getById(id: string): BaseAnnotationDrawable;
     removeById(id: string): void;
+    /**
+     * 删除当前所选的标注，使用与按下 Delete 键相同的逻辑。如果删除了标注，则返回 true。
+     */
+    deleteSelectedAnnotation(): boolean;
     /**
      * Selects an annotation drawable by id.
      * @param {string} id

package/dist/types/plugins/annotation/BaseAnnotation.d.ts

@@ -56,6 +56,9 @@ export declare abstract class BaseAnnotation extends Event<AnnotationEvents> {
     protected exitButton?: HTMLButtonElement;
     protected firstPickedListener?: () => void;
     protected completedListener?: () => void;
+    protected subtractMode: boolean;
+    protected allDrawableList?: DrawableList;
+    protected additionMode: boolean;
     constructor(type: AnnotationModeType, viewer: BaseViewer, input: InputManager, drawList: DrawableList, osnapHelper: OSnapHelper);
     get canvas(): HTMLCanvasElement;
     get camera(): THREE.Camera;
@@ -70,6 +73,30 @@ export declare abstract class BaseAnnotation extends Event<AnnotationEvents> {
      */
     get isAnnotating(): boolean;
     setTouchHelper(mobileTouchHelper: MobileTouchHelperDrawable): void;
+    /**
+     * 设置挖空模式
+     * @param enabled 是否启用挖空模式
+     * @param drawableList 所有标注的列表，用于查找父标注
+     */
+    setSubtractMode(enabled: boolean, drawableList?: DrawableList): void;
+    /**
+     * 设置添加模式（合并图形模式）
+     * @param enabled 是否启用添加模式
+     * @param drawableList 所有标注的列表，用于查找相交的标注
+     */
+    setAdditionMode(enabled: boolean, drawableList?: DrawableList): void;
+    /**
+     * 查找包含指定点的父标注
+     * @param point 要检查的点
+     * @returns 包含该点的标注，如果没有则返回undefined
+     */
+    protected findParentAnnotationContainingPoint(point: THREE.Vector3): BaseAnnotationDrawable | undefined;
+    /**
+     * 计算多边形面积
+     * @param points 多边形顶点
+     * @returns 面积
+     */
+    protected calculatePolygonArea(points: THREE.Vector3[]): number;
     /**
      * 在移动端创建一个退出绘制的按钮（浮层按钮）。
      * 当用户触摸退出按钮时会结束当前绘制并隐藏按钮。
@@ -91,7 +118,7 @@ export declare abstract class BaseAnnotation extends Event<AnnotationEvents> {
     touchend: (e: EventInfo) => void;
     mousedown: (e: EventInfo) => void;
     mousemove: (e: EventInfo) => void;
-    mouseup: (e: EventInfo) => void;
+    mouseup: (_e: EventInfo) => void;
     dblclick: () => void;
     protected onMouseClick(e: EventInfo): void;
     protected selectAnnotationByEvent(e: EventInfo): void;

package/dist/types/plugins/annotation/BaseAnnotationDrawable.d.ts

@@ -55,7 +55,10 @@ export declare abstract class BaseAnnotationDrawable extends Drawable {
     protected selectedFillColor?: number[];
     protected dragVertexIndex: number | null;
     protected previewPoints: THREE.Vector3[] | null;
+    protected dragRingIndex: number | null;
+    protected previewRings: THREE.Vector3[][] | null;
     protected details: ClosedShape;
+    protected rings?: THREE.Vector3[][];
     protected ctx?: CanvasRenderingContext2D;
     parent?: BaseAnnotationDrawable;
     protected segmentLabelOffset: number;
@@ -72,11 +75,15 @@ export declare abstract class BaseAnnotationDrawable extends Drawable {
      */
     setSelectedFillColor(color: number[]): this;
     /**
-     * 开始拖拽顶点
+     * 开始拖拽顶点（仅外环 points）
      */
     beginDragVertex(index: number): void;
     /**
-     * 拖拽过程中更新预览点（不修改真实 points）
+     * 开始拖拽指定环上的顶点（0=外环，>=1=洞）
+     */
+    beginDragVertexAt(ringIndex: number, vertexIndex: number): void;
+    /**
+     * 拖拽过程中更新预览点（支持 points 与 rings）
      */
     updateDragPreview(position: THREE.Vector3, eventInfo?: EventInfo): void;
     /**
@@ -111,6 +118,12 @@ export declare abstract class BaseAnnotationDrawable extends Drawable {
     setData(data: AnnotationData): void;
     setParent(parent: BaseAnnotationDrawable): void;
     setParentId(parentId: string): void;
+    /**
+     * Update using multi-rings (outer + holes). Points will be set to the outer ring for compatibility.
+     */
+    updateRings(rings: THREE.Vector3[][]): this;
+    /** Get rings if present; fallback to single ring [points] */
+    getRings(): THREE.Vector3[][];
     update(points: THREE.Vector3[]): this;
     /**
      * 对封闭图形的点按从左上角顺时针方向排序

package/dist/types/plugins/annotation/FreeDrawAnnotation.d.ts

@@ -6,62 +6,88 @@ import type { OSnapHelper } from "../../core/helpers";
 import { EventInfo, InputManager } from "../../core/input/InputManager";
 import type { BaseViewer } from "../../core/viewers";
 /**
- * 自由绘制标注类
- * 用于处理自由绘制的标注功能
+ * 自由绘制标注工具
+ * 支持用户通过连续点击创建自由形状的标注，可实现复杂多边形的绘制
+ * 具备点击闭合、双击结束、智能点距控制等功能
  */
 export declare class FreeDrawAnnotation extends BaseAnnotation {
+    /** 相邻点之间的最小距离阈值（像素单位），用于避免冗余点 */
     private minPointDistance;
     constructor(viewer: BaseViewer, input: InputManager, drawList: DrawableList, osnapHelper: OSnapHelper);
     /**
-     * 退出绘制
+     * 退出自由绘制模式
+     * 根据当前绘制状态决定是完成绘制还是取消绘制
      */
     exitDrawing(): void;
     /**
-     * 取消当前绘制
+     * 取消当前自由绘制操作
+     * 清理所有绘制相关的状态和对象
      */
     cancel(): void;
     /**
-     * 完成当前绘制
+     * 完成当前自由绘制操作
+     * 处理挖空模式、添加模式或正常完成流程
      */
     protected complete(): void;
     /**
-     * 设置提示内容
+     * 处理挖空模式操作
+     * 从已存在的标注中减去当前绘制的自由图形区域，实现复杂图形的挖空效果
+     */
+    private handleSubtractMode;
+    /**
+     * 处理添加模式操作
+     * 将当前绘制的自由图形与相交的标注合并，实现图形的扩展和洞的填充
+     */
+    private handleAdditionMode;
+    /**
+     * 设置工具提示内容
+     * 根据当前绘制状态显示相应的操作提示
      */
     protected setTooltipContent(): void;
     /**
-     * 创建标注drawable
+     * 创建自由绘制标注的可绘制对象
+     * @returns 创建的自由绘制可绘制对象，如果创建失败则返回undefined
      */
     protected createAnnotationDrawable(): BaseAnnotationDrawable | undefined;
     /**
-     * 重写鼠标点击处理，用于开始绘制
+     * 处理鼠标点击事件，实现自由绘制的交互式操作
+     * @param e 鼠标事件信息
      */
     protected onMouseClick(e: EventInfo): void;
     /**
-     * 开始绘制
+     * 开始自由绘制流程
+     * 通过第一次点击确定绘制的起始点，并初始化绘制状态
+     * @param e 鼠标事件信息
      */
     private startDrawing;
     /**
-     * 继续绘制（添加点）
+     * 继续自由绘制流程
+     * 通过后续点击向绘制路径中添加新的顶点，支持闭合检测和智能点距控制
+     * @param e 鼠标事件信息
      */
     private continueDrawing;
     /**
-     * 重写鼠标移动处理，用于连续绘制
+     * 处理鼠标移动事件，实现自由绘制的实时预览效果
+     * @param position 鼠标当前位置的世界坐标
      */
     protected onMouseMove(position: THREE.Vector3): void;
     /**
-     * 重写双击处理，用于快速结束绘制
+     * 双击事件处理器，提供快速完成绘制的便捷方式
      */
     dblclick: () => void;
     /**
-     * 将世界坐标转换为屏幕坐标
+     * 世界坐标到屏幕坐标的转换工具方法
+     * 用于计算点间距离以实现智能点距控制
+     * @param worldPos 世界坐标系中的3D位置
+     * @returns 对应的屏幕坐标2D位置
      */
     private worldToScreen;
     /**
-     * 从数据恢复标注
-     * 专用于JSON数据恢复，支持保持原始ID不变
-     * @param points 点集合
-     * @param customId 自定义ID，用于保持JSON中的原始ID
-     * @returns 创建的标注ID
+     * 从外部数据恢复自由绘制标注
+     * 专用于从JSON等持久化数据中恢复标注对象，支持保持原始标注ID不变
+     * @param points 标注的顶点集合
+     * @param customId 自定义标注ID，用于保持JSON中存储的原始ID
+     * @returns 成功创建的标注ID，失败时返回undefined
      */
     restoreFromData(points: THREE.Vector3[], customId?: string): string | undefined;
 }

package/dist/types/plugins/annotation/RectAnnotation.d.ts

@@ -12,43 +12,69 @@ import type { BaseViewer } from "../../core/viewers";
  */
 export declare class RectAnnotation extends BaseAnnotation {
     type: AnnotationModeType;
+    /** 矩形绘制的起始点坐标 */
     private startPoint?;
     constructor(viewer: BaseViewer, inputManager: InputManager, drawList: DrawableList, osnapHelper: OSnapHelper);
     /**
-     * 重写鼠标点击处理，用于矩形绘制
+     * 处理鼠标点击事件，实现矩形的交互式绘制
+     * @param e 鼠标事件信息
      */
     protected onMouseClick(e: EventInfo): void;
     /**
-     * 开始绘制矩形
+     * 开始矩形绘制流程
+     * 通过第一次点击确定矩形的起始点，并初始化绘制状态
+     * @param e 鼠标事件信息
      */
     private startDrawing;
     /**
-     * 完成绘制矩形
+     * 完成矩形绘制流程
+     * 通过第二次点击确定矩形的结束点，并完成绘制
+     * @param e 鼠标事件信息
      */
     private finishDrawing;
     /**
-     * 退出绘制
+     * 退出矩形绘制模式
+     * 根据当前绘制状态决定是完成绘制还是取消绘制
      */
     exitDrawing(): void;
     /**
-     * 取消当前绘制
+     * 取消当前矩形绘制操作
+     * 清理所有绘制相关的状态和对象
      */
     cancel(): void;
     /**
-     * 完成当前绘制
+     * 完成当前矩形绘制操作
+     * 处理挖空模式、添加模式或正常完成流程
      */
     protected complete(): void;
     /**
-     * 设置提示内容
+     * 处理挖空模式操作
+     * 从已存在的标注中减去当前绘制的矩形区域，实现图形挖空效果
+     */
+    private handleSubtractMode;
+    /**
+     * 处理添加模式操作
+     * 将当前绘制的矩形与相交的标注合并，实现图形的扩展和洞的填充
+     */
+    private handleAdditionMode;
+    /**
+     * 设置工具提示内容
+     * 根据当前绘制状态显示相应的操作提示
      */
     protected setTooltipContent(): void;
     /**
-     * 创建标注drawable
+     * 创建矩形标注的可绘制对象
+     * @returns 创建的矩形可绘制对象，如果创建失败则返回undefined
      */
     protected createAnnotationDrawable(): BaseAnnotationDrawable | undefined;
     /**
-     * 重写鼠标移动处理，用于实时预览
+     * 处理鼠标移动事件，实现矩形绘制的实时预览效果
+     * @param position 鼠标当前位置的世界坐标
      */
     protected onMouseMove(position: THREE.Vector3): void;
+    /**
+     * 根据起始点和对角点更新矩形的四个顶点坐标
+     * @param opposite 矩形的对角点坐标
+     */
     private updateRectanglePoints;
 }

package/dist/types/plugins/annotation/RectDrawable.d.ts

@@ -18,7 +18,6 @@ export declare class RectDrawable extends BaseAnnotationDrawable {
     private getRectPoints;
     isPointInPath(p: THREE.Vector3): boolean;
     getVertexes(): THREE.Vector3[];
-    protected getPointsForSegmentLength(): THREE.Vector3[];
     getClassType(): string;
     /**
      * 重写更新方法，绘制时保持2个对角点，完成时转换为4个顶点
@@ -28,6 +27,12 @@ export declare class RectDrawable extends BaseAnnotationDrawable {
      * 完成绘制时，确保使用完整的4个顶点
      */
     finalizePoints(): void;
+    /**
+     * 支持环顶点拖拽：
+     * - 若已有 rings（包含洞），则按多环顶点拖拽处理
+     * - 若无 rings（经典矩形），则走矩形四角拖拽逻辑
+     */
+    beginDragVertexAt(ringIndex: number, vertexIndex: number): void;
     /**
      * 重写拖拽开始方法，处理4个顶点的拖拽
      */

package/dist/types/plugins/divide/DividePlugin.d.ts

@@ -178,7 +178,7 @@ export declare class DividePlugin extends Plugin {
      * 取消图框创建
      * @param drawable 要取消的绘制数据
      */
-    cancelFrameCreation(drawable: FrameDrawable): void;
+    cancelFrameCreation(drawable?: FrameDrawable): void;
     /**
      * 从JSON数据恢复图框
      * 根据保存的角点坐标重新创建图框

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "dxfview",
-    "version": "0.0.4-beta.10",
+    "version": "0.0.4-beta.11",
     "homepage": "",
     "module": "dist/dxfview.esm.min.js",
     "main": "dist/dxfview.esm.min.js",