dxfview 0.0.2

package/dist/types/core/viewers/DxfViewer.d.ts

@@ -0,0 +1,1372 @@
+/**
+ * @fileoverview DxfViewer 类 - DXF/DWG 文件的 3D 查看器核心组件
+ *
+ * 这个文件实现了 DxfViewer 类，该类继承自 BaseViewer，专门用于渲染和交互 DXF/DWG 格式的工程图纸。
+ * 主要功能包括：
+ * - 3D 场景渲染和相机控制
+ * - 图层管理和可见性控制
+ * - 实体选择和交互
+ * - 标注和测量功能
+ * - 布局视图切换
+ * - 标记和注释系统
+ *
+ * @author DxfViewer Team
+ * @version 1.0.0
+ */
+import * as THREE from "three";
+import { CSS2DRenderer } from "three/examples/jsm/renderers/CSS2DRenderer.js";
+import { DxfModelConfig, DxfViewerConfig } from "../../core/Configs";
+import { Box2, // 矩阵自动更新设置
+Vector2 } from "../../core/Constants";
+import { Drawable, DrawableData } from "../../core/canvas";
+import { // DXF 实体
+DxfLayer } from "../../core/dxf";
+import { ILayoutObject } from "../../core/dxf-parser";
+import { FontManager } from "../../core/font";
+import { EventInfo } from "../../core/input/InputManager";
+import { MarkupManager, MarkupType } from "../../core/markup";
+import { Model2d, ModelData2d } from "../../core/model";
+import { BaseViewer, ViewerName } from "../../core/viewers/BaseViewer";
+import { MeasurementData, MeasurementType } from "../../plugins/measure";
+import type { MeasurementPlugin } from "../../plugins/measure";
+/**
+ * @typedef {DrawableData} MarkupData
+ * @description DxfViewer 的标记数据类型
+ *
+ * 标记数据包含额外的布局信息，例如布局名称。
+ * DxfViewer 不维护模型和标记数据之间的关系，业务逻辑应该知道
+ * 一组标记数据属于哪个模型。
+ *
+ * 这个类型继承自 DrawableData，扩展了基础的可绘制数据结构，
+ * 用于支持 DXF 查看器的标记功能，如注释、测量等。
+ */
+export declare type MarkupData = DrawableData;
+/**
+ * @interface EntityData
+ * @description 实体数据接口
+ *
+ * 这个接口定义了 DXF 实体的数据结构，包含实体所属的模型和图层信息。
+ * 用于在查看器中唯一标识和定位一个实体对象。
+ *
+ * @property {string} modelId - 模型唯一标识符，用于区分不同的 DXF 文件
+ * @property {string} layerName - 图层名称，表示实体所在的图层
+ */
+export interface EntityData {
+    modelId: string;
+    layerName: string;
+}
+/**
+ * @interface DxfLayers
+ * @description DXF/DWG 图层组接口
+ *
+ * 这个接口定义了一个图纸的所有图层集合，包含图层名称到图层对象的映射。
+ * 用于管理和组织 DXF 文件中的图层信息，支持图层的显示/隐藏、颜色设置等操作。
+ *
+ * @property {string} modelId - 模型唯一标识符，对应具体的 DXF 文件
+ * @property {Record<string, DxfLayer>} layers - 图层映射表，键为图层名称，值为图层对象
+ */
+export interface DxfLayers {
+    modelId: string;
+    layers: Record<string, DxfLayer>;
+}
+/**
+ * @interface PdfLayers
+ * @description PDF 图层组接口
+ *
+ * 这个接口定义了一个 PDF 文件的所有图层集合，虽然主要用于 DXF 查看器，
+ * 但也支持 PDF 文件的图层管理功能。
+ *
+ * @property {string} modelId - 模型唯一标识符
+ * @property {Record<string, PdfLayer>} layers - PDF 图层映射表，键为图层名称，值为图层对象
+ */
+export interface PdfLayers {
+    modelId: string;
+    layers: Record<string, PdfLayer>;
+}
+/**
+ * @interface PdfLayer
+ * @description PDF 图层接口
+ *
+ * 这个接口定义了单个 PDF 图层的属性和状态信息。
+ * 用于控制 PDF 图层的显示和交互行为。
+ *
+ * @property {string} name - 图层名称，用于标识和显示
+ * @property {string} id - 图层唯一标识符
+ * @property {string} index - 图层索引，用于排序和定位
+ * @property {boolean} visible - 图层是否可见，控制显示状态
+ */
+export interface PdfLayer {
+    name: string;
+    id: string;
+    index: string;
+    visible: boolean;
+}
+/**
+ * @interface PdfData
+ * @description PDF 数据接口
+ *
+ * 这个接口定义了 PDF 文件的数据结构，虽然主要用于 DXF 查看器，
+ * 但也支持 PDF 文件的渲染和交互功能。
+ *
+ * @property {THREE.Object3D} threejsObject - 整个 DXF/PDF 文件的根 Three.js 对象
+ * @property {Record<string, PdfLayer>} layers - 图层映射表，包含所有图层信息
+ * @property {Record<string, THREE.Object3D[]>} layersAndThreejsObjects 可选 - 按图层名称组织的 Three.js 对象数组
+ * @property {number} loadedEntityCount - 已创建/加载的实体数量，主要用于日志记录，不是精确值
+ */
+export interface PdfData {
+    threejsObject: THREE.Object3D;
+    layers: Record<string, PdfLayer>;
+    layersAndThreejsObjects?: Record<string, THREE.Object3D[]>;
+    loadedEntityCount: number;
+}
+/**
+ * Threejs 对象按以下树状视图组织：
+ *
+ * - modelLevelObject1              (THREE.Group, name = <modelId>)
+ *     - layoutLevelObject1         (THREE.Group, name = <布局名称>, 用于控制布局可见性)
+ *         - entityLevelObject1     (THREE.Point/Line/Mesh/Group)
+ *
+ * - 图层 threejs 对象
+ * {
+ *    layerName:[threejsObject1,threejsObject2,threejsObject3,...] (THREE.Point/Line/Mesh)
+ * }
+ */
+/**
+ * @class DxfViewer
+ * @description DXF/DWG 文件查看器类 - 专业的工程图纸 3D 查看器
+ *
+ * "dwg"是"drawing"的缩写，是AutoCAD保存的文件格式。
+ * "dxf"是数据交换格式，可以从dwg文件转换而来。
+ * 我们无法直接读取dwg文件，需要先通过ODA转换为dxf格式。
+ *
+ * 支持的DXF版本：AutoCAD 2018。同时支持二进制和ASCII格式。
+ *
+ * JSON编码：UTF-8编码，无BOM
+ *
+ * 坐标系统：右手坐标系，Y轴向上
+ *
+ * 关于单位：
+ * - 距离单位遵循主DXF文件的单位
+ * - 面积单位遵循主DXF文件的单位
+ * - 角度单位为"度"，逆时针方向
+ * - 时间单位为"秒"
+ *
+ * 颜色：使用rgb/rgba，值范围0-1
+ *
+ * 关于DxfViewer中的测量：
+ * - 测量由DxfViewer生成
+ * - 测量数据应该由用户存储，以便稍后恢复到DxfViewer中
+ * - DxfViewer管理测量数据，可以创建、删除、隐藏等
+ * - DxfViewer不维护测量与布局之间的关系
+ *
+ * 关于DxfViewer中的标记：
+ * 标记与测量非常相似
+ *
+ * 关于DxfViewer中的热点：
+ * - 热点由用户创建和存储
+ * - 热点可以添加到DxfViewer中，也可以从中移除
+ * - 调用者应该设置在当前DxfViewer会话中唯一的热点ID
+ * - DxfViewer不会隐藏热点，用户可以自己操作
+ * - DxfViewer不维护热点与布局之间的关系
+ *
+ * 关于布局：
+ * - 每个布局都有自己的主视图
+ * - 切换到另一个布局时，会清除所有测量、标记和热点
+ * - 切换到另一个布局时，会停用任何正在进行的操作，如测量、标记等
+ *
+ * 关于叠加：
+ * - 只要浏览器有足够的内存、CPU/GPU等，就支持添加任意数量的模型
+ * - 第一个模型称为"主模型"，其他的称为"叠加模型"
+ * - 忽略叠加模型的图纸空间
+ * - 如果叠加模型的单位与主模型不同，应该转换为主模型的单位
+ * - 在getLayers()中会添加modelId作为前缀
+ *
+ * 关于比较：
+ * - 只比较"模型"空间
+ * - 比较具有相同句柄和类型的实体
+ * - 比较实体的几何形状、位置、缩放等
+ * - 忽略图层的可见性、冻结设置
+ * - 忽略实体的属性，如线型、线宽、填充图案、字体、颜色等
+ * - 忽略块引用的空间过滤器（xclip）
+ * - 忽略与图层相关的操作，如将实体移动到另一个图层、更改图层颜色等
+ * - 默认情况下，"添加"的实体以绿色渲染，"删除"的实体以红色渲染，"修改"的实体由两部分组成，一个"删除"和一个"添加"
+ *
+ * 关于撤销/重做：
+ * - 支持测量和标记操作的撤销/重做。例如：创建/删除/移动标记
+ * - 设置/移除一批测量或标记将被视为一个操作
+ * - 切换到另一个布局会清除所有撤销/重做历史记录
+ *
+ * 关于对象捕捉（OSnap）：
+ * - 支持捕捉到线的端点和中点
+ * - 支持捕捉到两条线的交点
+ * - 支持捕捉到垂直于线的垂足
+ * - 支持捕捉到线上的任意点
+ *
+ * @example
+ * ``` typescript
+ * const viewerCfg = {
+ *     containerId: "myCanvas",
+ *     enableSpinner: true,
+ *     enableLayoutBar: true,
+ * };
+ * const modelCfg = {
+ *     modelId: "id_0",
+ *     name: "sample",
+ *     src: "http://www.abc.com/sample.dxf",
+ * }
+ * const fontFiles = ["http://www.abc.com/hztxt.shx", "http://www.abc.com/simplex.shx"];
+ *
+ * const viewer = new DxfViewer(viewerCfg);
+ * await viewer.setFont(fontFiles);
+ * await viewer.loadModelAsync(modelCfg);
+ * ```
+ */
+export declare class DxfViewer extends BaseViewer {
+    /**
+     * @internal
+     */
+    name: ViewerName;
+    private readonly CAMERA_Z_POSITION;
+    private readonly CAMERA_MIN_ZOOM;
+    private timer;
+    /** @protected CSS2D渲染器 - 用于在场景中渲染HTML标签 */
+    protected css2dRenderer?: CSS2DRenderer;
+    /** @protected 字体管理器 - 处理文本渲染 */
+    protected fontManager?: FontManager;
+    /** @protected 是否启用选择功能 */
+    protected enableSelection?: boolean;
+    /** @protected 当前选中的对象 */
+    protected selectedObject?: THREE.Object3D | Drawable;
+    /**
+     * 已加载的模型列表
+     * 记录的"键"是modelId或src
+     * @internal
+     */
+    loadedModels: Model2d[];
+    /**
+     * 主模型ID - 指示主模型，应该是第一个加载的模型
+     * @internal
+     */
+    masterModelId: string;
+    /** @private DXF布局栏组件 */
+    private dxfLayoutBar?;
+    /** @private Three.js加载管理器 */
+    private loadingManager?;
+    /** @private 射线投射器 - 用于对象拾取和交互 */
+    private raycaster?;
+    /** @private 相机更新定时器 */
+    private cameraUpdateInterval?;
+    /** @protected 是否选中状态 - TODO: 与selectedObject重复？ */
+    protected selected: boolean;
+    /** @private 标记管理器 - 管理活动布局的标记 */
+    private markupManager?;
+    /** @private 缩放至矩形区域辅助工具 */
+    private zoomToRectHelper?;
+    /**
+     * @private 请求动画帧辅助工具 - 用于提升渲染性能
+     * 启用此功能后，只在必要时渲染，例如相机位置改变、模型加载等
+     * 通过将raf设置为undefined可以禁用此功能
+     */
+    private raf?;
+    /** @private 时钟对象 - 用于时间相关的计算 */
+    private clock;
+    /** @protected 渲染启用状态 - 与RafHelper配合使用 */
+    protected renderEnabled: boolean;
+    /** @private 超时符号 - 与RafHelper配合使用 */
+    private timeoutSymbol?;
+    /** @private 是否启用隐藏视觉上过小对象的功能 */
+    private enableHideVisuallySmallObjects;
+    /** @private 已排序的可隐藏对象 - 键为布局名称，visibleMinZoom表示当相机缩放大于此值时对象可见 */
+    private sortedHidableObjects;
+    /** @private 上次相机缩放值 - 初始为无穷大，用于隐藏小对象 */
+    private lastCameraZoom;
+    /** @private 上一帧编号 - 用于确定场景是否已渲染，从而决定在捕捉时是否更新可射线投射对象 */
+    private lastFrame;
+    /** @private 当前活动布局名称 */
+    private activeLayoutName;
+    /** @private 布局信息映射表 - 不同布局包含不同的数据，例如边界框、测量结果等 */
+    private layoutInfos;
+    /** @private 单位系统 */
+    private units;
+    /** @private 可射线投射对象缓存 - 用于提升性能 */
+    private raycastableObjects;
+    /** @private FPS工具 - 用于性能监控 */
+    private fpsUtils;
+    /** @private 正在拖拽的标注可绘制对象 */
+    private draggingAnnotationDrawable?;
+    /** @private 正在拖拽的顶点索引 */
+    private draggingVertexIndex?;
+    /**
+     * DxfViewer构造函数
+     *
+     * 初始化DXF查看器的核心功能，包括Three.js场景、DOM元素、
+     * 输入管理器、事件系统、相机控制器等。
+     *
+     * @param viewerCfg - 查看器配置参数，包含容器ID、功能开关等设置
+     *
+     * @example
+     * ```typescript
+     * const viewer = new DxfViewer({
+     *     containerId: "viewer-container",
+     *     enableSpinner: true,
+     *     enableLayoutBar: true,
+     *     enableSelection: true
+     * });
+     * ```
+     */
+    constructor(viewerCfg: DxfViewerConfig);
+    /**
+     * 初始化查看器所需的所有组件和功能
+     *
+     * 这个方法按照特定的顺序初始化查看器的各个子系统：
+     * 1. Three.js 核心组件（场景、相机、渲染器）
+     * 2. DOM 元素和UI组件
+     * 3. 输入管理器（鼠标、键盘事件处理）
+     * 4. 事件系统（自定义事件监听）
+     * 5. 相机控制器（视角控制和交互）
+     * 6. 其他辅助组件
+     *
+     * @internal 内部方法，不应由外部直接调用
+     */
+    protected init(): void;
+    private initInputManager;
+    /**
+     * 交互模式：
+     * select 模式：左键点击选择，鼠标中键拖拽平移；鼠标样式为默认；
+     * move 模式：左键拖拽平移（与中键一致），鼠标样式为 pan/grab
+     */
+    private currentInteractionMode;
+    /**
+     * 切换用户交互模式
+     *
+     * DxfViewer支持两种主要的交互模式：
+     * - "select"模式：用于选择和查看对象，左键点击选择对象
+     * - "move"模式：用于快速平移视图，左键拖拽即可平移
+     *
+     * 两种模式的鼠标行为：
+     * select模式：
+     *   - 左键：选择对象
+     *   - 中键：拖拽平移视图
+     *   - 鼠标样式：默认样式
+     *
+     * move模式：
+     *   - 左键：拖拽平移视图（与中键行为一致）
+     *   - 鼠标样式：抓取样式(pan/grab)
+     *
+     * @param mode - 要设置的交互模式 ("select" | "move")
+     *
+     * @example
+     * ```typescript
+     * // 切换到移动模式，方便快速浏览
+     * viewer.setInteractionMode("move");
+     *
+     * // 切换到选择模式，进行对象交互
+     * viewer.setInteractionMode("select");
+     * ```
+     */
+    setInteractionMode(mode: "select" | "move"): void;
+    /**
+     * 初始化Three.js核心组件
+     * 包括场景、渲染器和相机
+     */
+    private initThree;
+    /**
+     * 初始化DOM相关组件
+     * 包括加载指示器、CSS2D渲染器、进度条和布局栏
+     */
+    private initDom;
+    /**
+     * 初始化Three.js场景
+     * 设置背景色和矩阵更新策略
+     */
+    private initScene;
+    /**
+     * 初始化WebGL渲染器
+     * 配置渲染参数并设置到DOM中
+     */
+    private initRenderer;
+    /**
+     * 初始化CSS2D渲染器
+     * 用于渲染HTML标签和标注
+     */
+    protected initCSS2DRenderer(): void;
+    /**
+     * 初始化正交相机
+     * 设置相机位置、缩放和投影矩阵
+     */
+    private initCamera;
+    /**
+     * 初始化相机控制器
+     * 设置鼠标和触摸交互行为
+     * @internal
+     */
+    protected initControls(): void;
+    /**
+     * 窗口大小改变时的回调函数
+     */
+    private onResize;
+    /**
+     * 相机控制改变时的回调函数
+     * @param viewer - DxfViewer实例
+     */
+    protected onControlsChange(viewer: DxfViewer): () => void;
+    /**
+     * 初始化鼠标/指针事件
+     * 处理各种交互事件如点击、拖拽、键盘快捷键等
+     */
+    private initEvents;
+    protected initOthers(): void;
+    private initLoadingProgressBar;
+    /**
+     * 显示布局栏
+     * @internal
+     */
+    showLayoutBar(): void;
+    /**
+     * 隐藏布局栏
+     * @internal
+     */
+    hideLayoutBar(): void;
+    protected animate(): void;
+    /**
+     * 启用渲染以提升性能
+     *
+     * 为获得更好的性能，应该只在必要时进行渲染。通常在以下情况应该启用渲染：
+     * - 对象被添加到场景、从场景移除，或对象的position、scale、rotation、opacity、material等属性发生变化
+     * - 对象被选择或取消选择
+     * - 相机发生变化
+     * - 渲染区域大小发生变化
+     *
+     * 这个方法会设置一个超时，在指定的时间后自动禁用渲染，从而避免不必要的渲染开销。
+     *
+     * @param time - 渲染启用持续时间（毫秒），默认为1000ms
+     * @internal 内部方法，主要由框架内部调用
+     *
+     * @example
+     * ```typescript
+     * // 手动启用渲染，持续2秒
+     * viewer.enableRender(2000);
+     *
+     * // 使用默认时间启用渲染
+     * viewer.enableRender();
+     * ```
+     */
+    enableRender: (time?: number) => void;
+    /**
+     * 获取当前的FPS（每秒帧数）值
+     *
+     * 返回当前查看器的实时渲染帧率，用于性能监控和调试。
+     * FPS值反映了渲染性能的高低，数值越高表示性能越好。
+     *
+     * @returns 当前的FPS值
+     * @internal 内部方法，主要用于性能监控
+     *
+     * @example
+     * ```typescript
+     * const fps = viewer.getFps();
+     * console.log(`Current FPS: ${fps}`);
+     * ```
+     */
+    getFps(): number;
+    /**
+     * 判断是否为3D查看器
+     *
+     * DxfViewer是2D查看器，专门用于渲染DXF/DWG格式的工程图纸。
+     * 这个方法返回false，表示当前查看器不支持3D渲染。
+     *
+     * @returns 总是返回false，因为DxfViewer是2D查看器
+     * @internal 内部方法，用于框架内部的查看器类型判断
+     */
+    is3d(): boolean;
+    /**
+     * 销毁 DxfViewer 实例
+     *
+     * 彻底清理和释放 DxfViewer 占用的所有资源，包括：
+     * - 停止所有异步任务和动画循环
+     * - 销毁UI组件（布局栏、标记管理器等）
+     * - 清理Three.js资源（渲染器、几何体、材质等）
+     * - 移除事件监听器
+     * - 释放内存和GPU资源
+     *
+     * 注意：销毁顺序很重要，例如测量功能依赖于渲染器，
+     * 必须在销毁渲染器之前先销毁测量功能。
+     *
+     * 调用此方法后，DxfViewer实例将不可用，所有相关资源都会被释放。
+     *
+     * @example
+     * ```typescript
+     * // 销毁查看器实例
+     * viewer.destroy();
+     *
+     * // 此时viewer实例已不可用，不应再使用
+     * ```
+     */
+    destroy(): void;
+    /**
+     * 用于指示有多少个DXF文件正在加载
+     */
+    private loadingDxfCount;
+    /**
+     * 异步加载DXF文件
+     *
+     * 加载DXF/DWG格式的工程图纸文件，支持主模型和叠加模型的概念：
+     *
+     * **主模型 vs 叠加模型：**
+     * - 第一个加载的文件将被视为"主模型"
+     * - 后续加载的文件称为"叠加模型"
+     *
+     * **加载内容差异：**
+     * - **主模型**：加载所有内容，包括模型空间和图纸空间
+     * - **叠加模型**：仅加载模型空间，且只能叠加到主模型的模型空间上
+     *
+     * **功能特性：**
+     * - 支持进度回调，实时显示加载进度
+     * - 支持本地缓存以提升性能
+     * - 支持模型合并优化
+     * - 支持编码设置（处理不同字符集的DXF文件）
+     * - 支持颜色覆盖（统一修改模型颜色）
+     * - 自动处理图纸空间的忽略逻辑
+     *
+     * @param modelCfg - 要加载的模型配置
+     * @param onProgress - 加载进度回调函数，可选
+     *
+     * @returns Promise<void> - 当模型加载完成时resolve
+     *
+     * @example
+     * ```typescript
+     * // 基本用法
+     * const viewerCfg = {
+     *     containerId: "myCanvas",
+     *     enableSpinner: true,
+     *     enableLayoutBar: true,
+     * };
+     *
+     * const modelCfg = {
+     *     modelId: "primary_model",
+     *     name: "主模型",
+     *     src: "http://example.com/primary.dxf",
+     *     merge: true,              // 启用模型合并优化
+     *     encoding: "utf-8",        // 文件编码
+     *     ignorePaperSpace: false,  // 不忽略图纸空间（仅对主模型有效）
+     * };
+     *
+     * const viewer = new DxfViewer(viewerCfg);
+     *
+     * try {
+     *     await viewer.loadModelAsync(modelCfg, (event) => {
+     *         const progress = (event.loaded * 100) / event.total;
+     *         console.log(`加载进度: ${progress.toFixed(1)}%`);
+     *
+     *         // 可以在这里更新UI进度条
+     *         updateProgressBar(progress);
+     *     });
+     *
+     *     console.log("模型加载完成！");
+     *
+     *     // 现在可以加载叠加模型
+     *     const overlayCfg = {
+     *         modelId: "overlay_model",
+     *         name: "叠加模型",
+     *         src: "http://example.com/overlay.dxf",
+     *         merge: true,
+     *     };
+     *
+     *     await viewer.loadModelAsync(overlayCfg, (event) => {
+     *         const progress = (event.loaded * 100) / event.total;
+     *         console.log(`叠加模型加载进度: ${progress.toFixed(1)}%`);
+     *     });
+     *
+     * } catch (error) {
+     *     console.error("模型加载失败:", error);
+     * }
+     * ```
+     *
+     * @example
+     * ```typescript
+     * // 加载多个模型的示例
+     * const models = [
+     *     { modelId: "floor1", name: "一层平面图", src: "floor1.dxf" },
+     *     { modelId: "floor2", name: "二层平面图", src: "floor2.dxf" },
+     *     { modelId: "structure", name: "结构图", src: "structure.dxf" },
+     * ];
+     *
+     * for (const model of models) {
+     *     await viewer.loadModelAsync(model, (event) => {
+     *         console.log(`${model.name} 加载进度: ${(event.loaded * 100 / event.total).toFixed(1)}%`);
+     *     });
+     * }
+     * ```
+     */
+    loadModelAsync(modelCfg: DxfModelConfig, onProgress?: (event: ProgressEvent) => void): Promise<void>;
+    /**
+     * 卸载DXF模型
+     *
+     * 从查看器中移除指定的DXF模型，清理相关资源。
+     * 这个方法目前还没有实现，是为未来版本预留的功能。
+     *
+     * @param modelId 可选 - 要卸载的模型ID。如果不提供，则可能卸载所有模型
+     * @internal 内部方法，暂未实现
+     * @throws {Error} 抛出"Not implemented yet!"错误，表示功能尚未实现
+     *
+     * @example
+     * ```typescript
+     * // 未来版本中的使用方式
+     * viewer.unloadDxf("model_001");
+     * ```
+     */
+    unloadDxf(): void;
+    /**
+     * 将模型数据添加到查看器
+     *
+     * 这个方法负责将加载的DXF模型正式集成到Three.js场景中，
+     * 设置必要的属性和状态，确保模型能够正确渲染和交互。
+     *
+     * @param modelData - 2D模型数据，包含模型ID和DXF数据
+     * @returns 返回创建的Model2d实例
+     * @description 将模型数据添加到查看器中进行渲染和管理
+     *
+     * @example
+     * ```typescript
+     * const modelData = {
+     *     modelId: "my_model",
+     *     dxfData: loadedDxfData
+     * };
+     * const model = viewer.addModel(modelData);
+     * ```
+     */
+    addModel(modelData: ModelData2d): Model2d | undefined;
+    /**
+     * 获取已加载实体数量
+     * @internal
+     * @returns {number}
+     */
+    getEntitiesCount(): number;
+    /**
+     * 获取已加载的dxf模型id数组
+     */
+    protected getLoadedDxfModelIds(): string[];
+    /**
+     * @description {en} Gets layout names of the master model.
+     * @description {zh} 获取主模型的布局名称。
+     * @returns
+     * - {en} Layout names of the master model.
+     * - {zh} 主模型的布局名称。
+     * @example
+     * ```typescript
+     * const layoutNames = dxfViewer.getLayoutNames();
+     * console.log(layoutNames); // ['Model', 'Layout1', 'Layout2']
+     * ```
+     */
+    getLayoutNames(): string[];
+    /**
+     * 获取布局。
+     * 仅返回主模型的布局。
+     */
+    protected getLayouts(): ILayoutObject[];
+    private handleOverlayDxf;
+    /**
+     * @description {en} Activates a layout.
+     * @description {zh} 激活布局。
+     * @param layoutName
+     * - {en} The name of the layout to be activated.
+     * - {zh} 要激活的布局名称。
+     * @example
+     * ```typescript
+     * viewer.activateLayout('Layout1');
+     * ```
+     */
+    activateLayout(layoutName: string): void;
+    private cancelAllOperations;
+    /**
+     * @description {en} Gets active layout.
+     * @description {zh} 获取当前布局。
+     * @returns
+     * - {en} Active layout name or undefined.
+     * - {zh} 当前激活的布局名称或undefined。
+     * @example
+     * ``` typescript
+     * const activeLayout = viewer.getActiveLayoutName();
+     * console.log(activeLayout);
+     * ```
+     */
+    getActiveLayoutName(): string | undefined;
+    /**
+     * @description {en} Gets dxf layers.
+     * @description {zh} 获取dxf图层。
+     * @returns
+     * - {en} Dxf layers.
+     * - {zh} dxf图层。
+     * @example
+     * ``` typescript
+     * const dxfLayers = viewer.getLayers();
+     * for (let i = 0; i < dxfLayers.length; ++i) {
+     *     const layers = dxfLayers[i].layers;
+     *     const layerNames = Object.keys(layers).sort();
+     *     console.log(layerNames);
+     * }
+     * ```
+     */
+    getLayers(): (DxfLayers | PdfLayers)[];
+    /**
+     * 设置模型（即dxf文件）的可见性。
+     * @throws 如果modelId不存在则抛出异常。
+     * @internal
+     */
+    setModelVisibility(modelId: string, visible: boolean): void;
+    /**
+     * @description {en} Sets layer's visibility.
+     * @description {zh} 设置图层的可见性。
+     * @param layerName
+     * - {en} Layer's name to show or hide.
+     * - {zh} 要显示或隐藏的图层名称。
+     * @param visible
+     * - {en} Layer's target visibility.
+     * - {zh} 图层的目标可见性。
+     * @param modelId
+     * - {en} Useful when more than one model is loaded, if not specified, will use the master model.
+     * - {zh} 当加载了多个模型时有用，如果未指定，将使用主模型。
+     * @throws Error
+     * - {en}: Throws exception if given modelId doesn't exist.
+     * - {zh} 如果给定的modelId不存在，则抛出异常。
+     * @example
+     * ``` typescript
+     * // Hides layer "0"
+     * viewer.setLayerVisibility("0", false);
+     * ```
+     */
+    setLayerVisibility(layerName: string, visible: boolean, modelId?: string): void;
+    /**
+     * 设置图层的不透明度
+     * @internal
+     */
+    setLayerOpacity(layerName: string, opacity: number, modelId?: string): void;
+    /**
+     * 设置图层的颜色
+     * @throws 如果图层不存在则抛出异常。
+     * @internal
+     */
+    setLayerColor(layerName: string, color: number, modelId?: string): void;
+    /**
+     * 重置图层的颜色。
+     * @internal
+     */
+    resetLayerColor(layerName: string, modelId?: string): void;
+    /**
+     * @description {en} Sets font.
+     * This needs to be called before loading a dxf, it won't affect any loaded text.
+     * It accepts shx or typeface formats. For typeface, it only support passing in 1 font file in the array for now.
+     * @description {zh} 设置字体。
+     * 需要在加载dxf之前调用，不会影响已加载的文字。
+     * 支持shx或typeface格式。对于typeface，目前只支持传入1个字体文件。
+     * @param urls
+     * - {en} font file urls.
+     * - {zh} 字体文件链接。
+     * @example
+     * ```typescript
+     * viewer.setFont(["https://example.com/xxx.shx"]);
+     * ```
+     */
+    setFont(urls: string[]): Promise<void>;
+    getFont(): FontManager | undefined;
+    /**
+     * 设置加载管理器。
+     * @internal
+     * 需要在加载dxf之前调用，用于加载本地外部链接。
+     * @param manager
+     */
+    setLoadingManager(manager: THREE.LoadingManager): void;
+    /**
+     * 设置显示长度单位。
+     * @internal 尚未实现！
+     * @default 毫米
+     */
+    setDisplayLengthUnits(): void;
+    /**
+     * 设置显示面积单位
+     * @internal 尚未实现！
+     * @default 米
+     */
+    setDisplayAreaUnits(): void;
+    /**
+     * 设置显示小数位数
+     * @internal 尚未实现！
+     * @default 2
+     */
+    setDisplayPrecision(): void;
+    /**
+     * @description {en} Gets current view extent.
+     * This is useful for user to save this value as a viewpoint, and jump to this viewpoint next time.
+     * @description {zh} 获取当前视图范围。
+     * 用户可使用该接口获取当前视口范围，并在适当的场景下跳转到该视口范围。
+     * @example
+     * ``` typescript
+     * const box = viewer.getCurrentViewExtent();
+     * console.log("Current view extent:", box);
+     * ```
+     */
+    getCurrentViewExtent(): Box2;
+    /**
+     * @description Compatible with older versions, use MeasurePlugin instead
+     * @internal
+     * @deprecated use MeasurePlugin instead
+     */
+    get measurePlugin(): MeasurementPlugin | undefined;
+    /**
+     * @description {en} Activates one of "Distance", "Area" or "Angle" measurement
+     * @description {zh} 激活"距离", "面积" 或者 "角度"测量
+     * @param type
+     * - "Distance", "Area" or "Angle"
+     * @example
+     * ``` typescript
+     * viewer.activateMeasurement(MeasurementType.Distance);
+     * ```
+     * @deprecated use MeasurePlugin instead
+     */
+    activateMeasurement(type: MeasurementType): void;
+    /**
+     * @description {en} Deactivates measurement.
+     * @description {zh} 退出测量。
+     * @example
+     * ``` typescript
+     * viewer.deactivateMeasurement();
+     * ```
+     * @deprecated use MeasurePlugin instead
+     */
+    deactivateMeasurement(): void;
+    /**
+     * @description {en} Gets active measurement type.
+     * @description {zh} 获取当前激活的测量类型。
+     * @returns
+     * - "Distance", "Area" or "Angle" or undefined
+     * @example
+     * ``` typescript
+     * const measurementType = viewer.getActiveMeasurementType();
+     * console.log(measurementType);
+     * ```
+     * @deprecated use MeasurePlugin instead
+     */
+    getActiveMeasurementType(): MeasurementType | undefined;
+    /**
+     * @description {en} Gets all measurements.
+     * @description {zh} 获取所有测量数据。
+     * @returns
+     * - {en} measurement data array.
+     * - {zh} 测量数据数组。
+     * @example
+     * ``` typescript
+     * const measurementData = viewer.getMeasurements();
+     * console.log(measurementData);
+     * ```
+     * @deprecated use MeasurePlugin instead
+     */
+    getMeasurements(): MeasurementData[];
+    /**
+     * @description {en} Cancels current measurement. This won't deactivate measurement, rather, you can start a new measurement.
+     * @description {zh} 取消当前的测量绘制。这并不会退出测量，用户可以开始一个新的测量。
+     * @deprecated use MeasurePlugin instead
+     */
+    cancelMeasurement(): void;
+    /**
+     * @description {en} Sets measurement data.
+     * @description {zh} 设置测量数据。
+     * @param measurementData
+     * - {en} measurement data array.
+     * - {zh} 测量数据数组。
+     * @example
+     * ``` typescript
+     * const measurementData = [{
+     *     type: "Distance",
+     *     id: "c6ea70a3-ddb0-4dd0-87c8-bd2491936428",
+     *     points: [[0, 1000], [5000, 1000]],
+     * }];
+     * viewer.setMeasurements(measurementData);
+     * ```
+     * @deprecated use MeasurePlugin instead
+     */
+    setMeasurements(measurementData: MeasurementData[]): void;
+    /**
+     * Selects a measurement by id
+     * @internal
+     * @deprecated use MeasurePlugin instead
+     */
+    selectMeasurement(id: string): void;
+    /**
+     * Unselects a measurement.
+     * @internal
+     * @deprecated use MeasurePlugin instead
+     */
+    unselectMeasurement(): void;
+    /**
+     * @description {en} Removes a measurement by id.
+     * @description {zh} 根据id删除测量数据。
+     * @param id
+     * - {en} Measurement data id.
+     * - {zh} 测量数据id。
+     * @example
+     * ``` typescript
+     * const id = "c6ea70a3-ddb0-4dd0-87c8-bd2491936428";
+     * viewer.removeMeasurement(id);
+     * ```
+     * @deprecated use MeasurePlugin instead
+     */
+    removeMeasurement(id: string): void;
+    /**
+     * Sets a measurement's visibility.
+     * Note that, the markup should belong to active layout. You shouldn't update a markup of an inactive layout.
+     * @internal
+     * @deprecated use MeasurePlugin instead
+     */
+    setMeasurementVisibility(id: string, visible: boolean): boolean;
+    /**
+     * @description {en} Clears measurement results.
+     * @description {zh} 清除测量结果。
+     * @example
+     * ``` typescript
+     * viewer.clearMeasurements();
+     * ```
+     * @deprecated use MeasurePlugin instead
+     */
+    clearMeasurements(): void;
+    /** markup start **/
+    /**
+     * @internal
+     */
+    getMarkupManager(): MarkupManager | undefined;
+    /**
+     * @description {en} Activates markup feature.
+     * @description {zh} 激活标注功能。
+     * @param type
+     * - {en} markup type.
+     * - {zh} 标注类型。
+     * @example
+     * ``` typescript
+     * const markupType = MarkupType.Arrow;
+     * viewer.activateMarkup(markupType);
+     * ```
+     * @deprecated
+     */
+    activateMarkup(type: MarkupType): void;
+    /**
+     * @description {en} Deactivates markup feature.
+     * @description {zh} 退出标注功能。
+     * @example
+     * ``` typescript
+     * viewer.deactivateMarkup();
+     * ```
+     */
+    deactivateMarkup(): void;
+    /**
+     * @description {en} Gets active markup type.
+     * @description {zh} 获取激活的标注类型。
+     * @returns
+     * - {en} markup type.
+     * - {zh} 标注类型。
+     * @example
+     * ``` typescript
+     * const markupType = viewer.getActiveMarkupType();
+     * console.log(markupType);
+     * ```
+     */
+    getActiveMarkupType(): MarkupType | undefined;
+    /**
+     * Set markup stroke color
+     * @internal
+     */
+    setMarkupLineColor(r: number, g: number, b: number, a: number): void;
+    /**
+     * @internal
+     */
+    getMarkupLineColor(): number[] | undefined;
+    /**
+     * Set markup fill color
+     * @internal
+     */
+    setMarkupFillColor(r: number, g: number, b: number, a: number): void;
+    /**
+     * @internal
+     */
+    getMarkupFillColor(): number[] | undefined;
+    /**
+     * Set markup stroke line width
+     * @internal
+     */
+    setMarkupLineWidth(lineWidth: number): void;
+    /**
+     * @internal
+     */
+    getMarkupLineWidth(): number | undefined;
+    /**
+     * Set markup font size
+     * @internal
+     */
+    setMarkupFontSize(fontSize: number): void;
+    /**
+     * @internal
+     */
+    getMarkupFontSize(): number | undefined;
+    /**
+     * @description {en} Gets all markups.
+     * @description {zh} 获取所有标注数据。
+     * @returns
+     * - {en} markup data array.
+     * - {zh} 标注数据数组。
+     * @example
+     * ``` typescript
+     * const markupData = viewer.getMarkups();
+     * console.log(markupData);
+     * ```
+     */
+    getMarkups(): MarkupData[];
+    /**
+     * @description {en} Adds markups to active layout.
+     * @description {zh} 添加标注到当前布局。
+     * @param markupDataArray
+     * - {en} markup data array.
+     * - {zh} 标注数据数组。
+     * @example
+     * ``` typescript
+     * const markupData = [{
+     *     type: "ArrowMarkup",
+     *     id: "c6ea70a3-ddb0-4dd0-87c8-bd2491936428",
+     *     lineWidth: 2,
+     *     strokeStyle: "#ff0000",
+     *     fillStyle: "#ff000030",
+     *     points: [[0, 0], [1000, 1000]],
+     * }];
+     * viewer.setMarkups(markupData);
+     * ```
+     */
+    setMarkups(markupDataArray: MarkupData[]): void;
+    /**
+     * Sets a markup's visibility by id.
+     * Note that, the markup should belong to active layout. You shouldn't update a markup of an inactive layout.
+     * @internal
+     */
+    setMarkupVisibility(id: string, visible: boolean): boolean;
+    /**
+     * @description {en} Updates a markup.
+     * @description {zh} 更新标注。
+     * @param {MarkupData} markup
+     * - {en} markup data.
+     * - {zh} 标注数据。
+     * @returns
+     * - {en} Whether update successfully, true means success, false means failure.
+     * - {zh} 是否更新成功，true表示成功，false表示失败。
+     * @example
+     * ``` typescript
+     * const markupData = {
+     *    type: "ArrowMarkup",
+     *    id: "c6ea70a3-ddb0-4dd0-87c8-bd2491936428",
+     *    lineWidth: 3,
+     *    strokeStyle: "#ff0000",
+     *    fillStyle: "#ff000030",
+     *    points: [[0, 0], [1000, 1000]],
+     * };
+     * viewer.updateMarkup(markupData);
+     */
+    updateMarkup(markup: MarkupData): boolean;
+    /**
+     * @description {en} Removes a markup by markup id.
+     * @description {zh} 根据标注id删除标注。
+     * @param {string} id
+     * - {en} markup id.
+     * - {zh} 标注id。
+     * @returns
+     * - {en} Whether remove successfully, true means success, false means failure.
+     * - {zh} 是否删除成功，true表示成功，false表示失败。
+     * @example
+     * ``` typescript
+     * const markupId = "c6ea70a3-ddb0-4dd0-87c8-bd2491936428";
+     * viewer.removeMarkup(markupId);
+     * ```
+     */
+    removeMarkup(id: string): boolean;
+    /**
+     * @description {en} Clears markups.
+     * @description {zh} 清除所有标注。
+     * @example
+     * ``` typescript
+     * viewer.clearMarkups();
+     * ```
+     */
+    clearMarkups(): void;
+    /** markup end **/
+    /**
+     * Gets mouse hit result in world coordinate
+     * @example
+     * ``` typescript
+     * document.addEventListener("click", (event) => {
+     *     const result = viewer.getHitResult(event);
+     *     const loc = result?.location;
+     *     if (loc) {
+     *         console.log(`Clicked at x: ${loc[0]}, y: ${loc[1]}`);
+     *     }
+     * });
+     * ```
+     * @internal
+     */
+    getHitResult(event: MouseEvent | PointerEvent | EventInfo): Vector2 | undefined;
+    /**
+     * Gets hit result by Normalized Device Coordinates.
+     * Lower left coordinate: (-1, -1)
+     * Upper right coordinate: (1, 1)
+     */
+    protected getHitResultByNdcCoordinate(coord: Vector2): Vector2 | undefined;
+    /**
+     * @description {en} Asks user to select a box area, and zooms to it.
+     * @description {zh} 询问用户选择一个框选区域，然后缩放到该区域。
+     * @example
+     * ``` typescript
+     * viewer.zoomToRect();
+     * ```
+     */
+    zoomToRect(): void;
+    /**
+     * @internal
+     */
+    deactivateZoomRect(): void;
+    private getLayoutByName;
+    private getActiveLayoutInfo;
+    private getMsTransformMatrix;
+    private getLayoutExtentEx;
+    /**
+     * Shows objects for given layout, and hide any other layouts.
+     */
+    private showLayoutObjects;
+    private getLayoutViewports;
+    private setMaterialUniforms;
+    /**
+     * Checks if a layer is frozen for viewport (VP Freeze)
+     */
+    private isLayerFrozenForViewport;
+    private getFilteredViewports;
+    private generateObjectsByViewport;
+    private findSpatialFilter;
+    private getAnyMaterial;
+    private addSpatialFilterSection;
+    private getObjectsByBoundingBox;
+    private getDxfUnits;
+    private generateSectionsBySpatialFilter;
+    /**
+     * @description {en} resize viewer
+     * @description {zh} 重置视图大小
+     * @param {number} width
+     * - {en} width of viewer
+     * - {zh} 视图宽度。
+     * @param {number} height
+     * - {en} height of viewer
+     * - {zh} 视图高度。
+     * @example
+     * ```typescript
+     * const width = 800;
+     * const height = 600;
+     * viewer.resize(width, height);
+     * ```
+     */
+    protected resize(width: number, height: number): void;
+    /**
+     * @internal
+     */
+    getRaycaster(): THREE.Raycaster | undefined;
+    /**
+     * Gets the corresponding viewport by judging that the point is in the viewport
+     */
+    private getViewportByPoint;
+    /**
+     * Gets raycast-able objects by mouseEvent.
+     * @internal
+     */
+    getRaycastableObjectsByMouse(event?: EventInfo): THREE.Object3D<THREE.Event>[];
+    /**
+     * 根据给定的鼠标位置获取相交对象
+     *
+     * 使用射线投射技术检测鼠标位置与场景中的3D对象的相交情况。
+     * 这个方法是对象选择和交互的基础，用于确定用户点击了哪个对象。
+     *
+     * @param event - 鼠标事件信息，可选。如果不传入，则使用(0, 0)作为射线投射起点
+     * @returns 相交对象的数组，按距离排序（最近的在前）
+     * @private 内部方法，仅供框架内部使用
+     */
+    private getIntersections;
+    /**
+     * 重写：事件级缓存的射线相交
+     */
+    intersectObjectsCached(event: EventInfo, objects: THREE.Object3D[], recursive: boolean, cacheKey: string): THREE.Intersection<THREE.Object3D<THREE.Event>>[];
+    /**
+     * 处理鼠标点击事件
+     *
+     * 处理用户的鼠标点击交互，包括对象选择、取消选择等操作。
+     * 这个方法会检查各种状态（如测量模式、标注模式等）以避免冲突。
+     *
+     * @param event - 鼠标事件信息，包含点击位置、按钮状态等
+     * @private 内部方法，由事件系统调用
+     */
+    private handleMouseClick;
+    /**
+     * 处理标注顶点拖拽开始
+     */
+    private handleAnnotationVertexDragStart;
+    /**
+     * 处理标注顶点拖拽移动
+     */
+    private handleAnnotationVertexDragMove;
+    /**
+     * 处理标注顶点拖拽结束
+     */
+    private handleAnnotationVertexDragEnd;
+    private selectDrawableByEvent;
+    /**
+     * 检查对象是否为标注 drawable（鸭子类型检查）
+     */
+    private isAnnotationDrawable;
+    /**
+     * 从多个重叠的 drawable 中选择最小的区域
+     * 优先级：1. 面积最小的封闭图形 2. 长度最短的线条 3. 第一个
+     */
+    private selectSmallestDrawable;
+    /**
+     * 判断 drawable 是否为封闭图形
+     */
+    private isClosedShape;
+    /**
+     * 选择面积最小的封闭图形
+     */
+    private selectSmallestClosedShape;
+    /**
+     * 计算图形面积
+     */
+    private calculateShapeArea;
+    /**
+     * 选择最短的线条
+     */
+    private selectShortestLine;
+    /**
+     * 计算线条长度
+     */
+    private calculateLineLength;
+    /**
+     * 选择或取消选择一个对象。
+     * depthTest 默认关闭。当对象相互覆盖时，高亮效果会更加明显。
+     */
+    protected selectObject(object?: THREE.Object3D, depthTest?: boolean): void;
+    /**
+     * Clears the current selection
+     * @internal
+     */
+    clearSelection(): void;
+    /**
+     * 使相机飞向对象
+     */
+    protected flyToObjects(objects: THREE.Object3D[]): void;
+    /**
+     * 使相机飞向一个对象
+     */
+    protected flyToObject(object: THREE.Object3D): void;
+    /**
+     * 如果有当前选中对象，飞向它
+     */
+    protected flyToSelectedObject(): void;
+    /**
+     * 飞向随机对象（通过 alt + r）。
+     * 当数据错误或程序有bug时很有用，
+     * 这时我们在场景中看不到任何东西！
+     */
+    protected flyToRandomObject(): void;
+    /**
+     * Makes camera fly to target position with given lookAt position
+     * @param position camera's target position
+     * @param lookAt camera's new lookAt position
+     * @param targetCameraZoom camera's target zoom value
+     * @internal
+     */
+    flyTo(position: THREE.Vector3, lookAt: THREE.Vector3, targetCameraZoom?: number, animate?: boolean): void;
+    /**
+     * 将相机移动到目标位置
+     * @param position 2d位置
+     * @internal
+     */
+    goTo(position: Vector2, targetCameraZoom?: number, animate?: boolean): void;
+    /**
+     * @description {en} Moves camera to home view.
+     * @description {zh} 移动相机到主视图.
+     * @example
+     * ``` typescript
+     * viewer.goToHomeView();
+     * ```
+     */
+    goToHomeView(): void;
+    /**
+     * @description {en} Zooms to specific bounding box.
+     * @description {zh} 缩放到指定的包围盒.
+     * @param bbox
+     * - {en} 2d bounding box
+     * - {zh} 2d 包围盒。
+     * @example
+     * ``` typescript
+     * const box = { min: { x: 0, y: 0 }, max: { x: 10000, y: 10000} };
+     * viewer.zoomToBBox(box);
+     * ```
+     */
+    zoomToBBox(bbox: Box2): void;
+    /**
+     * @description {en} Zooms to view extent.
+     * @description {zh} 缩放到视图范围.
+     * @example
+     * ``` typescript
+     * viewer.zoomToExtent();
+     * ```
+     */
+    zoomToExtent(): void;
+    /**
+     * @description {en} Sets background color.
+     * @description {zh} 设置背景颜色。
+     * @param r
+     * - {en} Red channel value between 0 and 1.
+     * - {zh} 红色通道值，介于 0 和 1 之间。
+     * @param g
+     * - {en} Green channel value between 0 and 1.
+     * - {zh} 绿色通道值，介于 0 和 1 之间。
+     * @param b
+     * - {en} Blue channel value between 0 and 1.
+     * -{zh} 蓝色通道值，介于 0 和 1 之间。
+     * @example
+     * ``` typescript
+     * // {en} Sets background to gray
+     * // {zh} 设置背景为灰色
+     * viewer.setBackgroundColor(0.5, 0.5, 0.5);
+     * ```
+     */
+    setBackgroundColor(r: number, g: number, b: number): void;
+    /**
+     * Gets LayoutInfo by layoutName. It creats LayoutInfo if doesn't exist.
+     */
+    private getLayoutInfo;
+    /**
+     * 创建一个比包围盒大得多的地面平面。
+     */
+    private updateGroundPlane;
+    /**
+     * Compute bounding box of loaded models for active layout
+     * @internal
+     */
+    computeBoundingBox(): THREE.Box3;
+    /**
+     * Checks if an expected zoom value is valid, and adjust its value if necessary.
+     */
+    private checkAndGetLimitedCameraZoom;
+    private getVisiblePixelSize;
+    private setLayoutHidableObjectArray;
+    private statObjects;
+    /**
+     * Updates hidable objects' visibility once camera.zoom changed.
+     */
+    private updateHidableObjectsVisibility;
+    /**
+     * Updates raycaster threshold to a proper value, so user can easily pick points and lines
+     */
+    private updateRaycasterThreshold;
+    /**
+     * Updates camera zoom value for shader materials, which are created in DxfLoader
+     */
+    private updateCameraZoomUniform;
+}